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Preface 


Let's Investigate ilie inner-workings of your Arduino. It appears to be a simple machine, but it is not. 
Much effort has beet) Invested to make u easy to learn and use. Unfortunately, these good intentions can 
mask some of the Ardulno's underlying capabilities, You suspected that there was more, much more, 
under the simplistic veneer. 

You were right. 

This book Is about how Ardulno actually works. The ArduLno is a successful composite of design 
decisions that has evolved overtime. By giving you a more in-depth understanding of the complex 
technologies involved, you will see the Ardulno 'Internals" as elements to he changed and re-arranged 
to suit your design goats. 


Intended Audience 

Tills book is written for Arduino users of all stripes, from energetic newcomers to seasoned 
professionals. You already know what an Ardulno is, and you have some ideas about what It cat) 
accomplish for you.Y'ou most likely already own one or have access to one. These are not requirements, 
just guesses. Your Interest in Ardulno and Its inner mysteries is enough. 

We don't have to spend any time going over the eer/baslcs here; Introductory Arduino tutorials are 
everywhere. This hook both covers a lot of ground in depth and hopes to follow you on your journey; it's 
not meant ot be discarded and useless after you blink your first LED. 


What This Book Isn’t 

This book does not attempt to teach you bask electronics In any structured manner. However, because 
you're an Inquisitive and clever sort of person, you will probably pick up a lot of valuable electronic 
basics by looking at the example projects and exercises. Much effort and technical review has been 
invested to ensure the examples presented are based on sound design principles. 

This is also not an introduction to programming. It Is assumed that you know how to manipulate 
code with an editor and follow simple instructions to accomplish specific tasks. Again, your eurlous 
nature will let you absorb "by osmosis" some of the programming examples and styles illustrated in the 
book, which strive to be clear and well-written. 

In no way do any of these chapters contain dffthe Information available on a particular subject. 
Practical and useful information is presented; references to more detailed Information is given. Ardulno, 
tike any other complex system, is a moving target. As Heraclitus observed more than 2,500 years ago, you 
cannot step into the same river twice. It was true then and it remains true today, especially with the 
sw iftly evolvi n g Ard u ino. 

You should know that this book is not merely a collection of technical information without a 
context. The shiny polish of the Ardulno, as the world see It, hides layer after layer of complex solutions 
to complex design challenges. Revealing these layers in a meaningful and understandable order is what 
this book is all about. 
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PREFACE 


Fina ny. this book is not just a collection of random , unrelated Ardulno projects. The pro jects anti 
exercises In ibis book are included to Illustrate and reinforce important design principles, to 
incrementally build from simple to more complex designs, and finally to help you better Imagine what Is 
possible, both with Arduino and beyond. 


Chapter Overview 

I lave a look at the table of contents and get an Idea of Just how far down the rabbit hole we're going to 
go. This book strives to be a balanced source of technical reference material, so each chapter should be 
able to stand on Its own. 

It wouldn’t kill you 10 read the chapters In the order presented. However, feel free to jump around 
and sample what you like. There's more here than meets the eye. As a rule, the chapters go from the 
general to the specific. If you skip around a lot and get stranded, try backing up a chapter or two to make 
sure you have the proper grounding and then proceed forward agaLn. 

■ Chapter 1: Hardware 

We took at the available Ardulno models and take a peck Inside. 

* Chapte r 2: So ft w are 

We run into software at every level of Ardulno development. Here Is the overview. 

* Chapter 3: Atm el AYR 

The 'brain" of the Arduino Isa microcosm in Itself. Knowing what it can and 
cannot do cat) be the difference between success and failure in your project. 

* Chapte r4: Su pporting 1 1 ard wa re 

The rest of the components play important roles, as well. Knowing what they can 
do and their limits helps you huJLda better mousetrap. 

* Chap tc r 5: Ard u in o Software 

The free Ardulno -provided software will get you started quickly and easily. It looks 
simple but li isn't. 

* Chapter ft: Optimizations 

Many optimizations are possible in your sketches,, and this chapter shows you 
how to both implement them and verify them with precise measurement 
techniques. 

* Chapter 7: Hardware and Software Combined 

The cooperation of hardware and software,, when they cooperate at all, can 
produce amazing results. A detailed tour of the built-in peripherals in the AVR 
helps you do more with less code. The general purpose I/O ports, the 11 S ART 
I serial port), counters, timers, PWM outputs, and analog inputs are examined in 
detail, with examples. The use of Interrupts helps to maximize the cooperation 
between hardware and software. 

■* Chap te r ft: li^a in p le P io jec ts 

A blinking LED? Seriously? What it takes to actually blink an LED with authority. 

What it takes to make a more complex project: a digital clock. 
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* Chapter S: Project Management 

Dealing with development Issues, such as documentation, collaboration, and 
licensing. 

» Chapter 10: Hardware Design 

Slatting from the ground up. literally,, we cover the areas of expertise needed to 
design your own Arduino- compatible or not -so -compatible hardware. Tins 
includes power requirements, processor selection, and shield design. Several 
hardware design automation tools are examined. 

* Chapter 11: Software Design 

Beyond sketches: Making sound software decisions depends on knowing your 
options. Alternative development environments, library development and 
documentation, and PC -side applications are discussed. You can even design your 
own software tools. 

Chap Ler 12: Networking 

Networking your Arduino is as easy as deciding who you want to talk to a ini what 
you want to talk about; In theory, that is. In reality, it's always more complicated. 
Leverage the built -in communication capability of your Ardulnn to talk to a variety 
of interesting devices. Add application -specific hardware to extend your network 
as far as you want. Even a situ pie web server is possible with the addition of some 
inexpensive hardware. 

* Chapter 13: More Example Projects 

A small autonomous robot is in reality a collection of individual projects that must 
work together. You'll need everything you've learned so far in this book to make 
this one work. 


Summary 

The goal of this book is to bean exploration, compendium, and reference for the neglected inner- 
workings of the Arduino architecture. Leveraging this knowledge will save you time and improve the 
quality of your Arduino projects. Hopefully It will also spark your interest in embedded system design 
and prompt you towards more ambitious projects in the future. 

Good luck! Don't forget to have some fun along the way! 
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CHAPTER 1 



The hardware of the Arduino has evolved slowly since its introduction in 2005. Because Ardubm a s a 
concept is very much a combination of hardware aod software, it's important to have a good 
understanding of what's involved in both areas, bisweil as the areas where they overlap. Let's undertake 
a broad outline of the hardware part of the Arduino in this chapter, going into some detail in a few areas, 
as well as its history and how you'll play a part in its future. 


What Is an Arduino? 

Because of Arduino shLstory and evolution, there are many variations on what can be called an Arduino. 
The list grows longer every day. The official offering from the Arduino Team consists of the Arduino tJno 
and the larger Arduino Mega 2560. 

When most people think ofArduino h they Imagine the small, rectangular (and probably blue] 
printed circuit board [PC B]. This is properly called the I/O Board. See Figure 1-1. 



wrr 1- 1, The A r dif trio I/O J3*m rd. This is what most people think of when you say "A rduitur, " even 
though it's only one piece of a larger system. 


Chapter i hardware 


The 1/0 Board Is the physically tangible part of the Arduino .system. Technically speaking* the term 
Arduino covers the hardware, software, development team, design philosophy, and esprit de corps of the 
user community. Vet you'll often hear people say things like, "Please hand me that Arduino," or "Careful 
with that Arduino, Eugene." 

Arduino was originally developed Ln Ivrea, Italy. Ardu in of Ivrea was the king of Italy about a 
thousand years ago and Is celebrated In local history. The Piazza Gioberti hosts a pub named after this 
famous king, which some say is only named after the road it's on, the Via Arduino. 

The name Arduino is a masculine Italian name meaning "strong friend.” Being a proper name, 
Arduino is always capitalized. The model name lino Is stylized in all capitals only In the Logo on the PCB. 
For more on the history and heritage of Arduino, as well as mountains of other fascinating information, 
please see the Arduino web she, http://arduino.ee. 

The Arduino I/O Board has traditionally been based on the Atm el AVR ATmegaB and later 
derivatives. The I/O Board also contains a serial port, power supply circuitry, expansion connectors, and 
miscellaneous support components. The official Arduino FAQ states, * lt r s just an AVR development 
hoard" (www.arduino.cc/en/Hain/FAOi. This assumes that you know what an AVR is. If you read Chapter 
ii, you will. {Hint: an AVR is a programmable microcontroller chip.) See the simplified black diagram in 
Figure 1-2. 


USB Suriul Port 


Expansion Comi i: Liurti 


Arduino I/O Board 


Power Supply 


Processor 


Expansion Conne-clars 


me 1 -2. The Arduino I/O Board block diagram 


The Arduino Uno 

The Arduino Uno was announced cm September 25,201 1 at the New York Maker Fa ire. The model name 
Uno is Italian for the number one and Is Intended to correspond with the Uno Panto Zero, or 1.0 release 
of the Arduino software. Previous releases, numbered 0001 through 0022 have been considered alpha, or 
preliminary releases. 

The Arduino Uno maintains a remarkable resemblance to Its forebears. The physical form factor has 
remained the same. Over the years, the processor has been upgraded twice from the original ATmegaB 
with E5KB bytes of program memory, first to the ATmegalOB with lfiKB of program memory and then to 
the ATmega32B with 32KB bytes of program memory, wh lie remaining pin compatible. The nine-pin RS- 
232 serial connector and interface circuitry has been replaced with a virtual serial port using various USB 
interface chips. The power-supply circuitry has seen some refinement with extra over-current protection 
and intelligent power- source selection. 
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CHAPTER 1 HARDWARE 


Due to a temporary worldwide shortage of the beloved 28- pin dual inline package (DIP? version of 
the ATniega32fi processor (whose Atm el part number, to help differentiate It from the other packaging 
options, Is ATM EGA328P - PIJ , the first P being for picoPower technology and tlte second P meaning 
plastic DIP), a surface- mo uni version of the Ardulno Uno was released, dubbed the Ardulno Uno SMD. 
It’s functionally identical in operation to the Uno. The only drawback, is that the surface-mount 
processor can't easily he removed from the PC II, as was the case with the socketed D3P versions. See 
Figure I -3. 



Figure 1-3, TlteArduino Uno (left) and the Ardulno Uno SMD (right) 

If you're starling to get interested lit the details of the AtmelAVR, you’re lit luck! All will be revealed 
in Chapter 3, including packaging options, how all the pins work and what they do, as well as a good 
introduction to the Inner workings of this very capable device. For now, let’s focus on 3 low the Atm el 
AVR fits into the big picture, Ardulno- wise. 


Processor 

Tite main brain of the Ardulno Uno is the Atm el AVR ATmega328, the black, rectangular plastic block 
with two rows of pins protruding from its sides. On the SMD version, the processor is one of the two 
miniscule black squares soldered directly to the PCS. 

This device is essentially a computer on a chip, containing a central processing unit (CPU), memory 
arrays, clocks, and peripherals In a single package. See Figure 1-4. 
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figure 1-4. Simplified black diagram of the ATmega328 

The ATmega32ft chip is derived from the original Ardulno processor, the ATmegaB. It contains more 
memory and more peripheral capability than its predecessor while using less power. The ATmega32fl 
processor can operate from a wide range of power-supply voltages, from 1.8 V to 5.5V. This makes it well- 
suited for battery-powered applications. At the lowest voltages, the processor has a maximum clock rate 
of 4MlIz (millions of cycles per second). Increase the supply voltage to at least 2.7V, and you can 
increase the clock rate to 10MHz. To run at the rated maximum clock rate of 2tiMllz, the chip needs ac 
least 4.5V. The Ardulno I/O Hoard provides 5.0V for the ATmega32S chip, so it can run at any speed, up 
to the maximum of 20M I Iz. 

The current crop of ATniega328 chips from At me l feature the company's picoPower technology, 
which dramatically reduces power consumption In she device. These parts are designated with a P suffix: 
for example, ATmega32BP. The previous versions available were able to run either at lower voltages 
(such as the ATmega32BV] but not full speed, or at full speed but not at voltages below 2.7V. The 
picoPower technology eliminates this limitation, allowing both full speed |at appropriate supply 
voltages) and low power operation at reduced speeds. The picoPower parts don't even have a speed 
rating as a component of their part number, as the previous generation did (for example, ATmega328P- 
PU vs. ATmega32G-2QPU k 


Note Softie specialized I/O Board models are designed to be run at 3.3V. This limits the maximum clock rate to 
10 MHz. 


Although the new ATmega328 chip can run up to 2DMHz, the original ATmegafl topped out at 
16MHz. The 16MHz clock rate has been maintained in all subsequent Ardulno models to preserve 
compatibility. 

See Chapter 3 for more detailed Information about the Atmel AVH family of processors. 
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Serial Port 

The function of the serial port remains unchanged from the earliest days of Ardulno. The connectors 
have changed, but everyone pretends that everything Ls the same. From a functional perspective, this is 
certainly true. 

The serial port is used to communicate, lit the development stage of your Ardulno project, the 
communication is between the Arduino and your PC, where you're writing, compiling, and uploading 
your sketch to the I/O Board. In the application (or deployment) phase ofyour project, when your 
Arduino is performing Us intended purpose, Lite serial port may continue to communicate with your PC, 
if that is part of the plan, or it may communicate with another serial device. The use of the serial port is 
optional at the application stage, so li may he communicating with nothing at all. If this Is the case, the 
receive (RXl and transmit [TX] pins can be used as general-purpose input/output (I/O) lines. 

There are .several types of serial communication protocols. The Arduino’s serial port (internally 
referred to as the IJKART peripheral, or Universal Asynchronous/Synchronous Transmitter /Receiver) is 
used in an asynchronous mode, meaning it doesn't provide nr require an Independent clock signal. This 
mode of operation is identical to the serial ports of most PCs, also known as RS-232 ports. The built-in 
serial port hardware on the ATmega32B chip is capable of other modes of operation, Including 
synchronous mode, where a separate, dedicated signal carries the clock Information. The asynchronous 
method uses one signal to transmit data and another to receive data. Depending on your application 
requirements, you may need to transmit, receive, do both, or do neither. 


Cauti on Don’t connect FtS-23 2 signals directSy to your Arduino. Ttie typically high er- voltage R5- 232 si gnals 
can damage the circuitry on the board, including the processor. Always use an RS-232-to-TTL adapter when 
interfacing an Arduino to an RS-232 port. 


Power Supply 

The power supply circuit doesn't actually supply any power to the Ardulno. It only routes, regulates, and 
filters power supplied from an external source. The present circuit has evolved over the years to make it 
a convenient and almost foolproof process. The circuit selects the highest available voltage and uses that 
source to supply the remainder of thedrcuh. There Is even a resettable fuse installed on the board to 
help prevent damage in the event of a short, thus lessening the likelihood of an unauthorized thermal 
event. This Is a great example of how the Arduino Team has listened to the user community and added 
Incremental improvements to the product over the years. 

There are several ways to get power to your Ardulno. The simplest, at least initially, is to use the 
power supplied with the USB cable, which comes from your PC. The USB standard allows for the supply 
of up to lOBmA (milliamps, or 0. 1 amps) of current at 5.0V for an unenumerated USB device {that is, a 
device plugged into the USB bus but not properly identifying Itself to the host, such as a USB power tap] 
and as much as 500mA {0.5 amps) for a properly enumerated USB device. This Is more than enough 
electrical power to light up several LEDs and a few low-power sensors. It Isn't sufficient for larger 
electrical loads, such as relays, heaters, fans, motors, or solenoids. 

When the Ardulno isn't connected to a PC via the USB cable, regulated 5V power can be supplied ro 
it through the power expansion connector pins labeled 5V and GND. 


5 


CHAPTER 1 HARDWARE 


Caution A regulated 5V supply is required when supplying power via the 5V and GHD pins. An unregulated 
supply's voltage fluctuates with line voltage and load, with the distinct possibility ot exceeding the narrow voltage 
range and very likely causing permanent damage to one or more components, including the processor. The 
standard Arduino I/O Board provides a voltage regulator. Use it 


For unregulated supply voltage, a modular barrel connector is provided, with input voltages from 7V 
to 12V. It’s directly connected to a 5V regulator circuit. In theory, the Input voltage could be as high as 
20V, but the likelihood of the voltage regulator chip overheating increase*, which tan permanently 
damage the PCB. 

The latest design revisions of the Arduino PCBs have greatly Improved the ground planes where the 
voltage regulators are mounted, increasing their ability to dissipate waste heat. However, even with this 
improved cooling capability, a conservative estimate of the thermal resistance of the device is over 
100*CAV. meaning that the temperature of the device will rise over lOCTC from the ambient air 
temperature if 1W is dissipated via the device. That’s hot! Don’t push it too far! 

The barrel connector bas a 2.1mm diameter pm. This center pin of the barrel connector Is the 
positive terminal. The outer sleeve connector Is ground. The positive connection Is also wired to the Vin 
pin oat the expansion connector. The Vin pin can lie used to either supply power to tire shield (s] or route 
external power from shields hack to the main I/O Board. 

One very nice design feature of modern Arduino I/O Boards Is the ability to have multiple, different 
power supplies connected at once. The Intelligent power- switching circuitry selects the highest available 
voltage and routes that to the voltage regulator. 

If you bypass this circuitry and provide regulated 5V power directly to your Arduino (which you 
most certainly can do}, he careful that it truly fc regulated 3V that you're pumping in. You just bypassed 
all the safety devices that were put there for your protection. Again, If you know what you’re doing, 
that's fine. 

The Arduino Uno also bas a dedicated 3.3V regulator installed. Previous I/O Board designs relied on 
tbe small 3.3V regulator built Into the FTDJ USB interface chip. This smaller regulator, although 
effectively free of additional cost to the system, is only capable of supplying a maximum of 30mA (0.03 
amps] of current at 3.3V to the system. The Arduino Uno sports Its own 3.3V regulator l the LP2rtfl5 from 
National Semiconductor) that can supply a maximum of 1 50m A (0.13 amps) of current, but the Arduino 
web site still only admits to being able to supply 50mA. 


Expansion Connectors 

To make It easier to connect your Arduino to additional circuitry, four sets of expansion connectors are 
provided. The two connectors across the top edge of the PCB contain the digital pins, along with the 
analog reference input and an additional ground connection. The USART TXand RX pins arc among 
these pins, as well. 

Along the bottom edge of the PCB are the power and analog connectors. The power connector 
provides connections to the main supply voltages (Vin, 5V, 3V3, and ground) along with a connection to 
the microcontroller's -RiiStiT pin. The analog connector brings out the six analog inputs, which can also 
he used as digital I/O titles If need be. 

A very handy feature of the Arduino PCI! artwork is that every pin is clearly labeled. This 
considerably reduces or eliminates tedious cross-referencing between data sheets and code listings. See 
Figure 1-5. 
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2-5. The IlO Board's expansion connectors allow additional circuitry to be easily connected. 


One of the buried technical details of the Arduino is the naming and grouping of the I/O pins within 
Hie expansion connectors. In Arduino- speak, the pins are simply numbered: DQ-D13 for the 14 digital 
pins and AO -A 5 for the fi analog pins. The digital pins run along the top edge of the hoard, and the analog 
pins are on the bottom edge. 

This naming convention, although widely adopted and referenced extensively hi the Arduino 
documentation and software. Is both misleading and inaccurate. Some of the digital pins provide the 
analog outputs (sec the analogWrite{} function) bui are in reality pulse-width-modulation (PWM) or 
purely digital outputs. The analog Inputs can Just as easily be used in exactly the same manner as any of 
the other digital pins, either as digital inputs or as digital outputs, hut nemras analog outputs. 


Note You can use the analog pins AQ-A5 just like any of the other digital pins by referring to them as D14- 
D19. See Table 1-1. 


In AVR- parlance, the ATmegaft family, of which the Arduino Uno's ATmega32fl Isa derivative, has 
ihree general-purpose I/O ports. On the ATmegafl, these ports are named Port II. Port C, and Port D. 
Each port can have a maximum of eight 1^0 pins associated with It. There's much more information 
ahout the details of the AVR I/O ports in Chapter 3. 
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Some of this coo fusion over pin names and functions, and the subsequent misleading 
nomenclature, follows from the multifunctional nature of the device pins. Everyone of the general- 
purpose I/O pins on the ATmega32B has an alternate peripheral function, which can he selected in 
software. One example already mentioned are the serial port pins, RX and TX. Pin 2 (on the 2ft- pin DiPl 
from the AVR side is called PDil [I/O Port D, hit D). RXD [received data Input pin] id the USART 
peripheral, well as PCINTlfi (pin-change interrupt 16]. From the Arduino side, It's called DO tdigstal 
pin 0) or PX. 

There is a happy side to all this conflicting naming and renaming. Both the Arduino and the AVR 
naming conventions work quite well for their Intended purposes and provide a nice overlapping 
symmetry to the circuit design. Just to be thorough, however, Table i-1 provides a list of all the 
expansion connector pin information. 


Table 1 - J r Arduino I/O Board Expansion Connector Pin Names 


Connector 

Arduino 

AVR 


DO/RX 

PDO/RXD 


rj l /tx 

PD1/TXD 


D2 

PD2/INT0 

Jl/IOI. 

D3/PWM 

PD3/INT1/OC2B 

DA 

PD4 


D5/PWM 

PD5/OCOB 


D6/PWM 

PD6/OCOA 


D7 

PD7 


DS 

PBO 


Dbt/PWM 

PB1/OC1A 

J3/IOII 

DiO/PWM 

PB2/OC1B 

Dll/PWM 

PB3/OC2A 


D 12 

PB4 


D 13/LED 

PBS 


fi 
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Connector 

Arduino 

AVR 


AQ/D14 

PCO/ADCO 


A1/D1S 

PCI /ADC i 

12/AD 

A2/D1S 

PC2/ADC2 

A3/D17 

PC3/ADC3 


A4/D IS 

PC4/ADC4/SDA 


AS/D 19 

PCS /ADCS/ SCL 


Note The surface-mount version of the ATmega328 chip [but not the DIP version) has two additional analog 
inputs available, ADC6 and ADC7. Unfortunately, these pins weren't connected to anything on the Arduino Uno 
SWID PCB. With a steady hand and some good soldering skills, it would be possible to tack some tiny wires onto 
these pads if you really, really needed one or two more analog Inputs. Sometimes you do. 


Shields 

The expansion conn triors are where sVj tehls are installed. Shields allow the I/O Board Loaet like a 
miniature motherboard, providing mechanical arid electrical connections to additional circuitry. A wide 
variety of shields are available, providing a mind-boggling array of expansion possibilities for your 
Arduino. 


Tip The Arduino Shield List is an excellent source of inform atiern on available shields and is available online 
at http://shieldlist.org. Ttie Arduino Shield List provides links to shield makers as well as information about 
compatibility, resource requirements (such as which pins are used), and licensing information. 


Some, but not all, shields have the same hoard outline as the main I/O Board. When installed, these 
fu 13 - si£c:d shields completely cover, or shield, the underlying I/O Board. The Maker Shield, designed by 
Marc de Vinck, is a versatile prototyping shield that uses stacking connectors to make mechanical and 
electrical contact with the Arduino I/O Board underneath. Instead of just providing mating pins to 
connect the shield to the Arduino DO Board, the stacking connectors replicate the expansion 
connectors, allowing yet another shield to he Installed on top of it. The prototyping area In the center of 
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i tie Maker Shield gives you a place to solder more components to extend the capabilities of y n u r 
Arduino. See Figure 1-6. 



Figure 1 The Maker Shield is a fu ll-slze Arduino shield that completely covers the Arduino underneath. 

Stacking connectors allow all the signals from the expansion connector to be replicated above, allowing 
another shield to be installed on top. The “sea of holes'* in the middle is for mounting additional 
components, extending the fuel tonality of your Arduino. 

For shields that don’t need that much space, or that only require a few closely placed electrical 
connections, a smaller shield form factor can he used. Only 4 output pins are required to drive a 12-LED 
array if you use a clever wiring Technique called char lie -plexing. You’ll learn more about Charlie -plexing 
in Chapter ft. Figure L-7 shows some prototype shields that can he Installed across any four contiguous 
I/O pins on the expansion connectors. 
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Figure 1-7, Smaller shields that use only a few I/O lines can he installed in the expansion connectors. The 
use of multiplexed connect ions allows up to a dozen LEDs to he individually addressed while only 
requiring four dedicated control lines from the Ardnina. 

It's even possible to build shields that are substantially larger than the Ij'O Board. One example Is 
the Arduino Piano Shield by Critter & Guitari i.hhw. e r it tci'and guitari. com), which j^ives the user a two- 
net ave piano-like keyboard and other user controls, turning your Arduinc into a musical synthesizer. See 
Figure i-fl. 
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Figure / -a. The Ardutno Piano Shield from Critter & Guitarl. This just might he the world's largest 
Arduino shield. it converts an Arduino into a complete music synthesizer with a two-octave button 
keyboard and additional user controls-. Photo by Critter &• Guftari. Used with permission. 

The spacing of the expansion connectors lias a alight irregularity. The connectors on the top edge 
arc spaced G.ifiO" apart, pin center to pin center, making them Incompatible with the 0.100" grid of 
snideries* breadboards and many other prototyping tools. This aberration has beet] maintained down 
through the years in the interest of continuity, despite loud outcries for its rectification. The overriding 
argument is that although ir would be easy enough to correct this issue, doing so would effectively 
decommission a Earge number of existing shields whose usefulness stems from reusability. So, the 
irregularity persists. 

Various workarounds have been implemented to correct the expansion connector spacing. 
Seeedstudio added two additional rows oi on- the -grid header pins to its Seeedulno Ardu in o -compatible 
product. See Figure i-if. 
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uuuuseeed s tudio.com 


Figure 1-9 The Seeeduino from Seeedstudio adds locations for Installing additional expansion 
connections that arc all on a strict Q.iOO" xO.S 00“ grid, making it much easier to install in solderless 
breadboards and other standard prototyping products. Image by Seeedstudio. Used t with permission. 

Another solution to the pin-spacing problem is to abandon shield compatibility completely. A IJS 
company, Gravitech (www.giavitfcch.ijs), manufactures theArdulno Nano. The Arduino Nano is 
designed to be directly Installed cm a solderless breadboard, with all connections (except the USB mini-B 
connector) being brought out as header pins with a 0.100” spacing. See Figure 1-ID. 
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Figure l'10 r Gravitech manufactures the Ardu ino Nana, which cart easily be installed in either a DIP 
socket or soiderless breadboard. The Nano contains all the electronics of the Duemilanove (see section 
"Ardu ino DuemUanove" for more) except for the barrel connector and reset table fuse. Photos by Cravttech. 
Used wit it permission. 


The Arduino Mega 2560 

hi almost every respect* the Arduino Mega is identical to its smaller sibling. It runs at the same 
speed □! 16MMz, requites approximately the same amount of power, executes the same software, and 
uses the same development tools. 

The primary difference between the Uno and the Mega Is the processor, the ATmega2S60 r which lias 
more memory and more peripherals than the ATmega328. The PCIi is also larger, hut it maintains form- 
factor compatibility with the standard Arduino, adding three additional expansion connectors along the 
right side and extending the PCR by approximately an inch in length. The remainder of the circuit is 
essentially Identical to the Arduino Uno. Sec Figure 1-11. 
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Figure l-ll. The Arduino Mega 2560 

The main difference between [be original Mega and the Mega 25BD model Is the processor used. The 
original Mega uses the ATmegal2BG with 12BKB of program memory. Tire Mega 2 5 BO model uses [he 
ATmega2560, with 256KE3 of program memory. The remaining characteristics of the two chips are 
basically identical. 

For a comparison between the Arduino Uno, the original Arduino Mega, and the Arduino Mega 
2580, see Table 1-2. 

f&bte I -2r Comparison of Arduino Uno anti Arduino Mega Capabilities 


Specification 

Arduino Uno 

Arduino Mega 1280 

Arduino Mega 2560 

Processor 

ATnvega328 

ATmegal2ftfl 

ATmega25fiG 

Program memory 

32KE3 

I2I5KB 

25BKB 

Data memory 

2KB 

&KB 

8KB 

EIIPROM 

1KB 

4KB 

4 KB 

Device pins 

28/32* 

100 

iuu 

Digital I/O phis 

14 

54 

54 

Analog Inputs 

6 

IB 

IB 

FWM outputs 

6 

14 

14 

Serial ports 

1 

4 

4 


r 28 pins for the DIP version of the ATmega328, and 32 pins for the HMD version. 
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Previous Hardware 

The Arduino Uno is the result of a relatively short I>ul active evolution. The original production hoards 
date back only to 200 S, so not a lot of time has elapsed. 

Several prototype versions of the Arduino I/O Board floated around before the familiar form factor 
emerged. These boards were designed to be easy to build from scratch. The goal was to get hoards into 
the hands of students, artists, and designers as quickly as possible. 


Arduino Serial 

The first Arduino hoard with the canonical form factor as you see it today was simply called the Arduino. 
See Figure l-l 2. 



Figure 1-12. The Arduino Serial. Photo by Nicolas Banzettl. 


The Serial designation came later to distinguish this design from ibe later ones that implemented a 
virtual serial port through USB. Technically, alt versions of the Arduino I/O Board use serial 
communication, so this Is something of a misnomer. 

The Arduino Board - Serial Interface sported an ATmegafl processor in a 23i- pin DIP. running at the 
(then) maximum clock rate of lfiMflz. It had a nine-pin female RS-232 connector (DE9) and discrete 
level-shifting and inverting hardware to convert the RS -232-level signals into a fJ-5V TTL-level that was 
compatible with the ATmegafl's US ART pins. Only three of the digital 3/0 titles had RWM capabilities. 

The power supply consisted of a single 5V regulator. Unregulated power could be supplied to the 
board via a barrel connector or the Vin pin on the expansion connector. Regulated SV could also be 
supplied directly via the SV pin of the expansion connector. No 3.3V power was used on this hoard. A 
single LED Indicated when power was applied. 

A iKB resistor was installed Inline with digital pin 13 (DT3)« This allowed the user to easily install a 
single LI2D In the expansion connector pin, which conveniently was adjacent to a UND pin. Laier 
versions of the board included the Dl3 LCD as a standard feature. 
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A reset switch was connected between the processor’s -RESET line and ground. When pressed, the 
processor rebooted Into the bootloader firmware and waited a short time fora new sketch to be sent 
from the PC. Falling this, the resident sketch {that is, whatever bad been programmed into tbe part most 
recently) was [hen executed. This required [he user to physically push [he reset button and time the 
sketch- uploading correctly. Later versions added auto-reset capability via tbe serLal port, eliminating the 
need to physically reset the Arduino before each upload. Unlike later boards, the processor's -RESET line 
wasn't brought nut to a pin on the expansion connector. 

The expansion connectors were typically populated with rows of male pins Instead of the more 
familiar female sockets that arc used today. Because these hoards were generally distributed as bare 
boards, the final decision was left to the builder. 

One additional six-pin connector was provided for Initially programming tbe hiank processors with 
the bootloader firmware. This connector was erroneously labeled ICSP for In-Circuit Serial 
Programming. ICSP. however, is the Microchip nomenclature for its PIC line of microcontrollers, 
popular then and now. The correct AVR terminology Is In-System Programming {ISP). This connector 
can he used to connect the Arduino I/O hoard direc tly to a device programmer, such as the Atmel 
AVR1SP or clones, bypassing the on-board bootloader. 

Additional {and sometimes expensive!) hardware, such as the AVR Dragon or fTAGICE mklt, along 
with the right software, allow on-chip debugging of the user's sketch in real time. I lard ware debugging, 
however, isn’t supported by any Arduino software. 


Arduino USB 

The next major mutation of the Arduino I/O Board lost the nine -pin RS-232 connector and replaced it 
with a USB interface. Both the PC -side software and the microcontroller hardware continued to believe 
it was a real, live serial port with baud rates and all that jazz. The FTDI USB Interface chip basically 
emulated a legacy serial port. See Figure 1-13. 



Pifurt 1-1$. The Arduino USB. This is the second USB version, which corrected a miring error on the 
a rigid a l USB design . 

This step was necessary because conventional serial ports were beginning to disappear from the PC 
landscape. The transition brought along the possibility of being powered directly from the host PC via 
the USB cable. The user could move a jumper on the PCB to select between USB or external power 
sources. 
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Arduino Extreme 

The Arduino Extreme began the trend of using female sockets for the expansion connectors. It also used 
more surface- mounted components than previously, Including LCDs to indicate TXand RX activity on 
the serial port. 


Arduino Nuova Generazione (New Generation) 

This Arduino model used an Improved FTDl USB interface chip that required fewer external 
components than the previous version, thus simplifying the layout and lowering the cost. Here Is where 
you saw the built-in LCD installed on D 13 as a standard feature. 

It was during the Arduino NG's tenure that the sw itch from ATmegaS to the newer ATmegalSfi 
occurred, doubling the program memory space from J3KE5 to IhKB. 


Arduino Diedmila 

Dieeimila means IP, Q00 in Italian, and this model commemorated the milestone of more than IP, BOO 
Arduino hoards produced. That's a lot of ArdulnosI 

Auto-reset was added to the Arduino Died mils* relieving die user from having to reach over and 
push the reset button every time a new sketch was uploaded. 

Also added was a resettable positive thermal coefficient (PTC) polyfuse in the power-supply section, 
which temporarily cut off power from the IJSB port if too much current was drawn. This protected both 
the Arduino and tire host PC. Technically, the host PC's USB hardware is supposed to monitor current 
consumption and shut down any excessively power-hungry devices, hut It turns out that not ail 
manufacturers adhere as strictly to the published USB standard as they might. An extra fuse costs little 
and saves much. 


Caution Please remember that any pre-Diecimila Arduino carries a potential risk of damage to your PC : s 
motherboard, it you manage to short out the 5V power supply. 


Arduino Ducmilanove 

The name Duemilanove is Italian for 2009, the year in which this model was Introduced. The power 
source selection jumper was gone, replaced by intelligent highest -voltage -seeking circuitry. During site 
Duemilanove's reign as flagship Arduino, the ATmegalGfi processor was upgraded to the ATmega32S r 
again doubling the program memory capacity, this time front IfiKB bytes to 32 KB. See Figure 1-14. 
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Figure 1~I4- The Arduino Duemiianom, ivlticlt j'.s Italian fur 2000, the year It was introduced. Photo by 
Wikimedia Commons user I lodges and placed in the public domain. 


Arduino Mega 

The original Arduino .Mega is very similar to die standard Arduino I/O Boards, just a little digger. It uses a 
physically larger processor chip, the ATmegal280, which is only available In a surface- mount package. 
The PCB has been extended on the right side to accommodate all the e*ira I/O lines while maintaining 
form-factor co m p atib Hi ty with exlstin g Du etn llano ve- co m p atiblc sh lelds. 


Who Makes Arduinos? 

The Arduino Team makes available all the design files, schematics, hoard layouts, source code, and other 
documents so that everyone who wants to can build and use their own Arduino. The only restrictions 
imposed arc on the usage of the name Arduino, which should refer to anything designed and supported 
by the Arduino Team. The rules concerning the terms Aftfriinoand A td u ino- com pa title art e v o 1 v l n g 
over time as needs change. 

The upshot Is that anyone can make an Arduino. You can make an Arduino. Get busy. 


Officially Licensed Products 

The official Arduino manufacturer is Smart Pro jects in Italy iwww. saartprj . com), which builds the 
Arduino lino and Mega boards. Additionally, SparkFun Electronics in the United States 
(www.sparkfun.com] builds the Arduino Pro, a minimalist Arduino Implementation that tacks a dedicated 
USB interface and is intended for designs that are to be directly embedded Into other devices. Because it 
has no built-in USB Interface, an additional adapter is required to upload sketches to the Arduino Pro. 
The thinking Is that a developer needs only one programming cable rather than redundant USB 
interfaces on every deployed circuit board. See Figure 1-15. 
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Figure 1-15. The Spark Fun Arduino Pro is a sTrlpped-dowm minimalist Arduino circuit. h requires an 
external USB adapter la upload sketches. PJwio hy SparkFun. Used unlit permission. 

SparkFun also manufactures the LilyFad Arduino, which Js the basis of an entire ecosystem oF 
wearable electronics, or e -textiles* The LilyPad Arduino was developed by Leah Buechley and designed 
hy Leah and SparkFun. See Figure 1-16. 



Figure 1-lS. The LilyPad Arduino was developed by Leah Buechley of The MIT Media Lab. It's designed la 
be sewn imo fabric using conductive thread to produce e- textiles, or wearable computers. Photo by 
SparkFim. Used with permission. 

The LilyPad Arduino can easily be used in noncraFty designs, where a minimalist approach is 
needed, or if you Just tike circular things that are purple. It's certainly a more aesthetically pleasing 
design than that boring old blue rectangle. 


Everybody Else 

Lots of manufacturers make and sell their own Arduino -compatible boards and shields. This Is perfectly 
in keeping with the Arduino Team's goals of getting the hardware and software out there and Into the 
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hands of as many people as possible. Again, as long as the name Arduino Is reserved for products 
specifically designed and supported by the Arduino Team, everybody Js happy. 

A comprehensive index of Arduino and Ardulno-compatlble hard ware designers and vendors is 
way, tway beyond the scope afthls book. A quick Internet search will uncover more manufacturers and 
vendors every day. 


Build Your Own 

You are empowered. Everything about the Arduino Is open. You have access to lire schematics, the board 
layouts, the source code* the tutorials* ibe user forums, and everything else that is Arduino. With all this 
at your disposal* why not build your own Arduino? 


Arduino Printed Circuit Boards 

You can buy a blank Ardulno-compatlble PCB from several sources, collect tbe necessary components* 
solder them Into place* and voiEi! You can say that you built your very own Arduino. The Freedulno 
project [www.freeduino.orgl' alms to help you do just that. 

You can also download the artwork fora (mostly) single -sided PCI1 design directly from the Arduino 
web site (http : //a r d u i no . cc / o ri / il a in ./A r d u irto&oa rd Soria 1 S i ngleSideda) Th is lets you fab rlca te your 
own PCB using a few different methods. 

One method is the miter- transfer method. Using specially ireaied printer paper, you print the PCR 
artwork using a laser printer nr toner-based copier. The toner particles arc then transferred to a blank, 
copper-clad board using either an iron nr a modified badge lamina tor. After cooling* you remove the 
paper backing by snaking the board In water, leaving the Inner pattern adhered to the copper. Then, you 
slosh the hoard in an acid baib or wipe it with an acid-soaked sponge in remove the unwanted copper. 
The remaining copper forms the wiring of the board. You drill holes for the components, ideally using a 
drill press. The components are then installed and soldered Into place. 

Another method uses copper-clad panels that arc pretreated with photo-sensitive chemicals. The 
PCB artwork Is printed on transparency material and placed over the coated side of the copper panel (for 
best results, this should be done in a dark or dimly lit area). You then expose the board to sunlight, a 
strong UV (ultraviolet) lamp, ora really bright desk lamp. Doing so alters the chemical nature of the 
coating. The parts that were exposed to the light become resistant to the copper etch (acid). The process 
of removing the unwanted copper Is the same as the toner- transfer method. 

It's also possible to use a computer numerical control (CNC) machine to route out the unwanted 
copper on the board as well as to automatically drill the component holes in the right places. Not all 
hobbyists have access to this type of equipment today. Perhaps in the near future... 

If you don't want to actually ntake the PCBs yourself by hand, it's not too terribly expensive to send 
the available design flies to a professional PCB manufacturer and have it make you a few boards. Richard 
fames Meal, a.k.a. Laen of DorkbotPDX (http: //pub. laen.org), offers a low-cost prototyping service to 
hobbyists for small runs of PC Bs. At one time, the cost was $5 per square Inch of PCB [for three copies), 
with no minimum order and free shipping within tbe United States. See bis web site for current terms. 
This gets you three blank Arduino PCBs (2.1" x 2.7") for $26.35. The thee thing is that you can change up 
the board layout to suit your needs or artistic temperament* such as adding additional components, 
more connectors, or even a picture of your smiling face. Laen can accept CadSoft EAGLE flies (the 
format provided on the Arduino web site) or Industry-standard Gerber files. 

The next step up, which Is also cheaper per board, Is to send the artwork to a short-run PCB house, 
such as Gold Phoenix in China (www.goldphoenixpeb.biz)* where you can get a couple of dozen hoards 
made for just over U S$ I DC). This lowers the cost per board significantly, but it's practical only Jf you need 
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that many blackboards for your projects. You have to export the Arduinu- provided CadSoft EAGLE files 
into Industry-standard Gerber hies for Gold Phoenix. 


Tip You'll have to edit the files a bit to get all the helpful pin labels and component legends onto the proper 
silkscreen layers. The- Arduino- provided files seem to have their own idea of where all this information belongs. 


Gathering the rest of the components for your home-hullt Ardulno is straightforward, If you live in 
the United States nr United Kingdom. A complete parts list for the Ardulno Serial, with Parnell, ELFA. 
and DlglKeypart numbers thoughtfully provided, is available on the Ardulno web site 
(httpr/^ar duino.ee/en/Main/Paits5eri a 1V2). Other than the RGB, Lhe only tricky part to get Is ihe 
AT mega device of your liking, already p reloaded, with the Arduino bootloader. Without the bootloader 
programmed Into the chip, your board really Is "just an AVR development board." as per the Arduino 
FAQ. Herein lies the famous Ardulno bootloader chicken -and -egg conundrum. 

Factory -fresh ATmega AVRs don't have a bootloader* An AVR- specific device programmer or ISP Is 
required lo initially hurn the bootloader Image Into the program memory. From then on, you can easily 
upload sketches over the serial port front your PC. 


Breadboard Arduinos 

A printed circuit board Isn’t required. You can have all the hand -crafted -Arduino fun you want and not 
even have to learn to solder. A complete Ardulno-eompatlhle computer can he built on a very useful 
prototyping platform called a so Id er less breadboard. See Figure l - 17. 



Pigure 1-17. An Arduino-compatlble physical computing platform can be assembled on a solderless 
breadboard. 
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T b e term breadboard Is a hold-over from a very- mu eh -bygone age. Believe iior nor, before the 
Internet, people had to make things oat of whatever they happened to have on hand. Using a scrap piece 
of lumber as a substrate, you can taek down component leads using small nails or brads and connect the 
leads together to make a circuit. Often, the kitchen cutting board was enlisted when a more suitable 
piece of wood couldn't he found. 

Talented technology popular 1st Collin Cunningham demonstrates building a simple electronic 
circuit on a real breadboard, using a hammer, nails, and a pair of pliers. You can sec the video at 
http t blog. makez ine. com/ archive/ 201 i/QV coll ins- lab- the -zeal --breadboard., ht ml. 

Summary 

The Arduino I/O Board, although the most recognizable piece of I he Ardulno puzzle, Is only one of many 
components within the entire system. The basic idea of a small, low-cost, easy-to-use microcontroller 
has persisted through several generations of electronics and software, Each nunva generazione (new 
generation) makes incremental improvements to the performance, reliability, and usefulness of the 
system as a whole, 

Although primarily targeted at the Atm el AVR line of microcontrollers, there Is nothing written in 
stone that says ait Ardulno can't be built on a completely different foundation. Several non-AVR variants 
have emerged, as well as other designs based on other members of the vast Atm el AVR family. 

The basic idea remains shit pie: a dedicated, reprogrammable microcontroller, with the bare 
minimum of support components, that can perceive and interact with the world in some limited 
fashion, both as a building block for more sophisticated systems and a learning tool for aspiring design 
engineers. 

The open source nature of the project has allowed many thousands of developers to create their 
own Arduino -flavored variations to meet their project needs. Ardulno has drastically lowered the barrier 
to fairly advanced embedded controller design, while maintaining an accessible and easy-to-use user 
interface. This allows a much broader audience of potential Arduino users more opportunities to create 
new and fascinating solutions. It’s especially empowering to put this sort of accessible technology within 
the reach of ever younger children, providing them with the tools to build and create, instead of merely 
consume. 

The downside of the program is the oversimplification of the system, which masks the hidden 
potential of the hardware and software. Amazing things can happen when you tap into the true potential 
of any complex system. This is correctly called emergent behavior when surprising and perhaps 
unlmagincd capabilities arise from the Interaction of the various components. 

This chapter has covered the basics of Ardulno hardware and its origins. Now you know a little 
about the hardware part and a little about the history of the Arduino project. More important, if you 
weren't previously aware of it, you should he now: you are empowered. Nor only does the Arduino 
project pur amazing, enabling technology into the hands of thousands of creative people, it also 
challenges the traditional concepts of design, manufacturing, and commerce. 

The Ardulno project belongs to you as much as it belongs ro anyone, with the exception of a few 
tittle naming Issues. What wilt you do with it? What will be your part in the future of Arduino? 
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You find software everywhere when yon Look Inside and outside the Ardulno. Yon need software to talk 
to Ll'te Ardulno; the Ardulno needs software to listen. You use software to write sketches,, your sketches 
gel combined with the Ardulno libraries, and then mo pic software converts {compiles) your programs 
into the ones and items oF machine instructions that the AVR microcontroller cao understand. In reality, 
there's even more to it than this. 

This chapter serves only as an outline of all the software that is Involved in this adventure, to give 
you an overview off how much software Is Involved and what functions it serves. Chapter 5 covers the 
oFfteial Ardulno software In detail, Including the user interface. Theciever folks there have spent a lot of 
time making the software reliable, functional, and, above all, easy to use. 

Chapter 11 discusses some of the software design opportunities that exist in the Ardulno world. 
There's always room for improvement. You can tweak the existing software to meet your needs or 
preferences, or go completely nuts and replace it ali with tools of your own imagining. 


Hosts and Targets 

Working with Ardulno today means working with two computers at once: the Ardulno microcontroller 
and your PC. In the embedded development world, your PC is the fiost computer, and the Ardulno is the 
target computer. This is a different concept than the host and device designations for USB. Although the 
Arduino, with the appropriate additional USB hardware, can play the part of either a USB device or a 
USB host, the host computer in the embedded development scenario is the computer on which the 
software is written and compiled. 

The Arduino- supplied software is designed in work on most popular operating systems, including 
Microsoft Windows, Apple Mac OS. and several varieties of Linux. 

Software — lots and tots nF software — is needed on both the host and the target computers. Because 
i he internal architectures of Lite; two systems are so different from one another, the process of developing 
software for one machine on a dissimilar machine is often called cross-platform development, or simply 
cross development. You'Ll also hear similar terms, such as cross com pliers and cross toolehains. These 
phrases are ail talking about tools that help produce executable code for a system other than the one on 
which the tools are run. 
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Step by Step 

Let's go through the hasic steps of programming your Ardulno to perform a trivial task: blinking an LED. 
The actual step-by-step guide for this simple hut important exercise Is given in Chapter 3, Tit Is section 
only covers the main topics without going into specific, implementation -specific details. 


Step 1: Write Some Code 

Most beginning Ardulno programmers don’t write their first sketch (Arduino program) by themselves. 
This Is true of most programming languages. There Is almost always a traditional, pared-down example 
exercise that is easy enough to complete in a single sitting yet complex enough to demonstrate that 
something Is actually happening. 


A Trivial Example in C 

In the C programming language, on which the Arduino programming language is built, the traditional 
first program is called "Hello, world," because It prints out those words on a console. Once upon a time, 
that console was a Teletype or CRT-based terminal. These days, ifs almost always a console window or 
terminal window floating on a screen foil of other windows or icons. The important thing is that the 
output is predictable and easily Identified as either correct or Incorrect. 

Printing a couple of words and some punctuation doesn’t sound like a big accomplishment (and 
truly, It’s not), but it provides compelling evidence that several key variables are it) place, not the least of 
which is that your too {chain ithe complete set of all the development tools, both in software and In 
hardware ) Is working properly. 


Note Don’t u n de resti mate th e vain e of confidence in you r tools. 


Listing 2-1 shows what the canonical " 1 1 ello , world” program looks like In the original C dialect. 


Liming 2-1, “f-Ieilo, World" in C 

/* Hello, world */ 

l? include <stdio.h> 

Int mairi{voi(l) { 

printf ("Hello, world Hui"); 
return t>; 


The first line, J* Hello, world */, is a comment, which is Ignored by the compiler but very useful to 
the humans who might need to read this code at so ore future date. Comments work the same way In the 
Arduino programming language. Consider adding useful and narrative comments In all your code. 
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Note Seff-doctim anting code is an oxymoron, as well as a poor excuse tor laziness, ft it was self-documenting, 
it wouldn’t be code, now would it? Don’t be lazy. Use comments. Go overboard. Be redundant. It costs 'little and 
pays mucti. 


The n i_-xi line, ^include < stdio, h>, tells the compiler to add the contents of a header fik\ In this case 
one with the filename stdie.h, into this program file. A header file often contains program definitions 
and declarations drat m ight prove useful in typical programs and have been collected together to 
prevent having to reiterate them every time you. write new code. Typically, header files (note the .h for 
header file extension! exist for each of the major operating system libraries (collections of useful 
functions, snippets, and subroutines! that are made available to the application programmer. The sidle 
system library contains many of the standard input and output functions as provided by tire C 
programming language. In the "Hello, world" example program, a single call to the prlnt-fQ function is 
used to sc tid a string of characters to the standard output device. The Arduino programming language 
provides many libraries and their associated header files, including stdio, which are used In the exact 
same manner as this example. 

Note that most of these terms are specific to the C programming language. You’ll often see them 
used in the Arduino world, because the Arduino programming language is derived from C and still hears 
a remarkable resemblance, although a fexv things have been changed along the way. 

The remainder of the program listing is the definition of the program's single function, named 
aain().This Is where all C programs start execution. Arduino Isa bit different, and for a very good 
reason, hut you'll get 10 that shortly. 

The first part of the function definition is where the function is named. Tire word void within the 
parentheses tells the compiler that tire function takes no arguments; li r s void of arguments. None are 
needed. The program Is going to print out "Hello, world" no matter what else you Lry to tell it. The int 
part tells the compiler that the function will return a value, and that this value will he expressed as an 
Integer rt umber. This convention reflects the rich heritage of the C programming language, where an 
application program such as "Hello, world" would be cn lied or invoked by an operating system, and a 
return value of some sort would he expected, perhaps to Indicate success or failure of the program to tire 
operating system. 

In theC programming language, everything is a function. This helps to divide larger programming 
tasks into smaller, more manageable chunks. The C model of functions caking arguments and returning 
values is taken directly from algebra. Even tire syntax is tire same. Arguments and return values are also a 
part of the Arduino programming language. 

Also Important is the other punctuation you sec in the example program. The opening and closing 
curly brackets or braces — { and }-are used to delineate the beginning and ending of tire body of the 
function definition. 

The semicolons ai the ends of the lines mark the end of complete program statements. The two 
program statements in this example are tire call to the library function printf[) and lire return 
statement, which Indicates the end of program execution and the return to the operating system. 

In lire Arduino programming language, there Is no operating system involved. Tire return statement 
is supported, hut only to return from a eal led fu ac lion to the caller or calling function, along with a 
supplied return value, If appropriate. 

The prlntf function call and the return statement are shown on separate lines, hut they need only 
be separated by a semicolon, as far as the compiler is concerned. Use your best Judgment in how you lay 
out your code. IVMfespflce (the areas between the printable text, assuming your screen background or 
paper is white] is cheap; use it Liberally. 
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Note Most syntax errors f oured by the co m pi ler will be due to simple punctuation probl e m s sucti as o m itted 
semicolons and unmatched parentheses. Look for these first when confronted with a screen full of error 
messages. Start with the first error message; ft probably caused a cascade of other errors. 


The argument passed to the pxintfO function is a string of both printable characters and 
formatting directives, enclosed between double quotes. The printf() function interprets the \m 
sequence to mean "‘add a new line here." Another useful whitespace code Is Vt for a tab character, which 
aligns the next output on a predefined column. A complete guide 10 LheprintfO function could fill a 
book all by itself. 

This code can be written with paint or charcoal on a cave wall; on paper with pens, pencils, or 
crayons; or In the air whh an airplane equipped for sky writing. Gut writing It In a form that can he 
effectively handled by a modern computing device requires [be services of some type of software, such 
as a text editor or word processor. 


Caution Word- processing software almost always inserts hidden formatting codes within the text which will 
probably confuse or at the least upset your compiler. Always save your computer programs as text-only files, or 
specify no formatting, ft possible. A programmer's editor is preferred, and examples are given later in this chapter 


Assuming the correctly typed example program has been entered Into a computing machine, li then 
needs to be saved to a /He (computer document ) [hai cat] later be found by the compiler. This requires 
the existence of an operating system (more software) with file- handling capabilities. Luckily, several 
options are available, depending on your preferences or present situation, for the purposes of this trivial 
example, a proper operating system is stipulated. 

The semi-hum an- readable document (that ls F only partially human-readable, not readable by semi- 
hum arts') now exists within the scope of a computer file system. This document is referred to as a source 
file, indicating that It is the o right of Lite programming process. The file Is subsequently processed 
through various stages to produce object files and eventually an executable binary Image. This binary 
image is composed of the actual ones and zeros that the target computer architecture (the Ardulno) can 
nati vely execute. 

Source files can also he produced by other forms of software, not just by carbon- based programmer 
types. 

Let’s skip over the details of the source-file- to -executable- image process fora moment and refocus 
on achieving the same results for an Ardulno. 


A Trivial Example in the Arduino Programming Language 

It’s not hard to port the existing "Hello, world" example program from traditional Cto theArduino 
programming language. There are, however, a few fundamental differences. These differences correctly 
reflect the distinctions between theArduino environment |an embedded system with no operating 
system) and more traditional application programming scenarios. 
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The first difference Li that there is tin explicit reference to any main() function. The main £} function 
exists, because this Is. after all, a C-derived language, hut Lt's supplied automatically by the system 
libraries. It isn't explicitly coded by the programmer. 

Instead of a*ain() function starting everything, Arduino has two Important functions: setupQ and 
loepO-Thc setup 0 function performs whatever one-time initializations need to be made. The loopO 
function is then called repeatedly, ad infinitum. The calling of the setup{) and loapQ functions Is 
handled automatically behind the scenes. The minimum Arduino program (that does exactly nothing, 
other than compile without errors) looks tike Listing 2-2. 

Listing 2-2. The Bare Minimum Arduino Sketch 

void setupO { 

} 


void leapt) { 

} 

The setup t) and Ioop() function definitions are required, even if they do nothing. If they're missing, 
you gee a nasty "undefined reference to ..." error message. Generally, you can find a good use for both of 
them In every Arduino sketch you write. Many examples are given Eater In this chapter as well as the rest 
of the book. 

For experienced C programmers, It may help to think of the basic Arduino sketch as already having 
the code in Listing 2-3 prewritten. 

LUt ins The Assumed C Code in Every Arduino Sketch 

void setup{void)j // setupO function prototype 
void loop (void); if IsopO function prototype 

int main{void) { 

sttupO; // perform whatever one-tine initializations are required 
while(l) { 

laopOj if repeat this over and over again 

} 

return 0; // this never happens 

} 


One otiter minor difference is that the Arduino doesn't know about your intended STMHJT device, 
which Is the Implied destination for the output from [he print f() function (that Is. the system console). 
You can point Li In the right direction using thefdevopenO function and supply a pointer to the function 
that sends a single character to that device. Then you get to define that function, as well. Within your 
print -single -character function, you can output the single, printable character via the virtual [or possibly 
aetuali serial port using the Arduino s Serial library. This requires that you specify the baud rate In the 
setup() function beforehand. This all sounds a Lot more complicated than It Ls; see Listing 2-4. 
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Lifting 2"4. “Hello, World" in theArduino Programming Language 
fllnclutfe <stdio.h> 

int serial_c.onst>li 2 _put£(chajr c t FILE *) { 

Serial. write(c) ; // send a single character out via the serial port 
return 0; / / indicate success 


void setups ) { 

Serial. t>cgin(9600} ; ti initialire the serial port 
fdovopen{aserial_console_putCj NULL}; // point STDOlit to serial port 
printf ("Hello > world !An" ); 

} 

void loop{) { 

1 


However, instead of clinging to the past, Let's embrace the New Way and simplify this example even 
Limber, by talking directly to the serial port without referencing legacy devices. See Listing 2-5. 

LittfHg 2- S. Hie Modern ''Hello, World" in theArduino Programming Language 

void setup() { 

Serial. t>cgin(96GQ}; 

^ er i al . pr i nt In ( " He 1 lo , wor Id t H ) ; 

} 

void loop{) { 

} 

Notice that the Serial .begin{) function calf In the sctup() function remains the same, establishing 
the comm uni cation rate. Instead of jumping through hoops to properly configure everything for the 
printft) function, you just use the print ln() method of the Serial object. The print ln() method 
automatically appends a newline (specifically, a carriage return and a linefeed character) after the 
designated text has been output. This effectively performs the same duty as the \n formatting directive 
within the printf{) function's argument. 

Move the Serial, pr intin () function call to the lot>p[} function, and you'll have a never-ending 
supply of "Hello, world!” statements being generated by your Arduino, tirelessly and unflaggingly, until 
you either reprogram it or remove power. 

To detect any of this alleged printing, you have to open a serial terminal window on your host PC. 
This function Is provided within theArduino 3DL. 


Another Trivial Example in the Arduino Programming Language 

To see your Arduino executing your commands with your hare eyes, you simply change output devices. 
Most modern Arduino I/O Boards come equipped with a built-in LCD on digital pin 13 (D13). 

As with the: serial port examples, a minimum of device setup is required to properly configure the 
pin that is driving the LCD. On power up, all of tire digital I/O pins on theArduino are configured as 
inputs. You need to change at least one of them (Ideally tire pin that is connected to tire LLDj to he an 
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output This crmfigu ration only needs to be performed once, so the proper place to do It is within the 
h ody of t he set u p [ ) fu notion . 

ThepinMode() function configures the device 1/0 pins. It takes two arguments; the first to specify 
which pin to configure* and the second to indicate a direction* either INPUT or OuiPUT. See Listing 2-fi. 

Listing 2-6. Another Trivia} Example in the Arduino Programming Language 
sdefine leu 13 
void setup() { 

pinHodefLEUj, OUTPUT); // &1J is now an output 

} 

void loopO { 

digital Write (LEO, HIGH); // turn on the LED 
delay(lODD); if one- second delay 
digitalwritc( LEO, LOW) ; // turn off the LED 
delay(lODD); // another one- second delay 

} 

The first line. ^define LEO 13, is a macro definition. This allows you to assign a value to a 
meaningful name. In this case, you associate the name LED with the number of the pin that (you hope) Js 
attached in an LED. Now, anywhere you type the name LEU, die compiler knows to substitute the 
numeric value 13 In Its place. Remember* it helps the humans when source code can he read by humans. 
Write for your audience. 

Within the loop{) function* you find two rhyming couplets. 3n each couplet you see two function 
calls. The first function is digltaIWrite(), which writes a digital tone or zero) value to a device pin. The 
predefined values HIGH and LOW correspond to the values one and zero, respectively. 

Writing a one (HIGH I to digital pin 13 causes the LED to turn on. A zero, or LOW value, causes the LED 
to turn off. 

ThedelayO function wastes a hit of time. The exact amount of time is specified in milliseconds 
(thousandths of a second) and passed as the argument. This results In a one -second delay between the 
LED changing stale. Without the dclay() function calls intermingled between the digltaLWriteQ 
function calls, the LED would blink so quickly that it would only appear as a blur, much too fast for the 
human eye to detect. 

Writing for stealing) die code is the easy part. Compiling it into a form that the chip can understand 
is a little more complicated. 


Step 2: Compile the Code 

The nice thing about the Arduino software is that It's generally very easy to use. Not a lot of configuration 
or tweaking is required to get it 10 work. You tell it what kind of Arduino you have, you 1 ell it what serial 
port it's on, and you’re done. All the heavy lifting is done behind the scenes. 

Let's take a look. 
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One Button Does It All 

The Arduino software doe* Its best to [00k like it's doing ail il te work. You push a button, and the 
software takes your beautiful source code, packs It down Into tiny ones and zeros, and then magically 
beams them into your Arduino. 

Trickery' Tlds isn’t what happens aiaH. Through some clever misdirection and legerdemain, the 
Arduino software enlists the help of many, many other software packages, most of which have never 
even been to Italy. 

The Arduino software takes your sketch, combines it with some boilerplate code (which looks a lot 
like Listing 2-3), and ihcn passes it to Lite avr-gee compiler. The avr-get compiler is the Atmel AVft port 
of the popular CiNTi Compiler Collection (GCC). GCC supports a wide range of computer systems, from 
the very tiny to the very powerful. 

The resulting object code is linked against the standard Arduino libraries (where things like Serial 
arc defined) as w‘cll as avr-libc, the open source C library for the Atmel AVft microcontrollers. The avr- 
binulils collection of tools is used in conjunction with the avr-gee compiler to produce the final 
executable image, which is formatted as an Intel 11CX file: a special file format that encodes a binary 
image and is recognized by many other software tools. 

The resulting HEX file is transmitted to the Arduino using another open source utility called avrduefa 
(AVR downloaded up loader). 

Within the ArduLno's microcontroller, even more software is working to make this one-button 
process look easy. The Arduino bootloader ts a tiny bit of resident firmware that remains in place outside 
of the area where the compiled sketch is stored. The bootloader is activated on power-up or whenever 
the processor is reset. This allows the Arduino IDE software to remotely reset the I/O Board and then 
send commands to the bootloader to store a newly compiled sketch. 

That's quite a button! 


The Tasks of the Compiler 

The compiler itself is really a collection of simpler programs that break down the task of source-code 
translation Into smaller, more manageable operations. Here are some enormous oversimplifications of 
some of the steps that are involved. 

The first thing the compiler does is to Invoke the preprocessor. This software’s responsibility is 10 
scan the source code for any required macro substitutions as well as splice together any other header 
files that have been referenced with Lite flin elude directive. 

Next the compiler performs a lexical analysis of the aggregated source code, breaking down each 
program statement inio individual toftens, or symbols. 

The compiler then parses the resulting sequence of tokens from the lexical analyzer, or scanner, to 
make sure the program cart be successfully converted into machine language instructions. This stage is 
sometimes referred to as syntactic analysis. The order of the tokens within the program is cheeked 
against a formal grammar, which states what does and does not constitute a valid program statement. 

When all of the original source code lias been analyzed and placed Into the compiler's internal 
chart, the process becomes fairly simple, If tedious. Each of the basic programming units recognized by 
the formal grammar has one or more possible real-world implementations. This varies according to the 
target dev lee. This Is where the avr-libc library comes In handy: Jt r s a collection of ail the basic 
computing tasks that may be required In a program, coded specifically for the Atmel AVft line of 
microcontrollers. 

If any additional libraries are needed to finish the process, they're included or linked together with 
the main program. This was once performed by a separate piece of software called a /inker but has lately 
been absorbed as yet another task of the compiler. 
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Nexl, the resulting con glam era [Inn of tilts and bytes is further analyzed Lo see if any space can be 
saved nr any performance can be Improved. This process is called optimization and is a mind- bend! ngly 
dark art, indeed. 

Finally (at least from the standpoint of the compiler suite), the resulting file is written In the 
appropriate file format for whatever step is next. Normally, this Is where the compiler hands tiff the 
baton to the device programmer, although In the case of Library development, more Lasksean be 
launched. 


Step 3: Program the Device 

After the source code has been successfully translated alt the way to machine code, there remains the Job 
of stuffing all thn.se slippery ones and zeros into that tiny chip. This Is where the device programming 
software and the bootloader do a Little dance together. 

For most Arduino uploads, the avrdude utility is used. This is norma lly a c ommand-llne utility, 
meaning It doesn’t have a fancy, windowed user Interface but instead receives Lis orders directly from 
(be command line. The Arduino IDE knows from your Board and Serial Port settings how to set up this 
complex set of Instructions, along with several other pieces of Information contained In the various 
Arduino configuration files. 


The Arduino Bootloader 

The final lap of this relay race Is handled by the bootloader firmware. This tiny bit of executable code Is 
burned Into the AVR’s program memory In a special location and can be configured to take over the chip 
on power-up or after a reset. The Arduino software tells the compiler to skip over this area when 
compiling a sketch; otherwise the bootloader would be overwritten when a new sketch was uploaded. 

The Arduino bootloader presents a bit of a chicken -and -egg problem for hobbyists. You need a 
dedicated device programmer to program the bootloader into a blank, factory -fresh chip, because chips 
don’t come from the foundry with bootloaders. After the bootloader is programmed, however. It’s very 
easy to upload new sketches to the program memory whenever needed. An Arduino I/O board can even 
be used as a device programmer, with some special wiring. But until you have the bootloader Installed, 
you don't yet have an Arduino, per se. 

One solution is to buy the chip with the bootloader already programmed. Someday, all 
microcontrollers w LEI co me with bootloaders from the factory. Many non-AVR devices already do. 


Step 4: l est and Debug 

Now that your sketch Is sitting pretty within the confines of the AVR’s program memory, it's time to test 
It and see if it fulfills all your hopes and dreams. This is why it's Important to have a simple first project 
ibat has a readily identifiable success marker. "Hello, world” served your forefathers well. The blinking 
LED Is another piece of evidence that is hard io argue. 

When your Arduino projects become more complex {and they will], it's always a good idea to be 
thinking about ways to test their performance, even before you start coding. Another good Idea is to have 
a clearly stated goal so you’ll know when you're finished. 
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Step 5. Repeat 

This entire process is just one loop through the development cycle. It’s almost always reiterated until the 
behavior of the resulting system meets the expectations of the designer, or until you rum out of fund Eng. 
Code, compile, upload, test, repeat. 

Thanks to the sophisticated hardware and software in the Arduino system,, this process Is now both 
fast and convenient. You hardly ever have to throw away a shoebox full of punched cards anymore fust 
because of a had choice In algorithms early In the design phase. 


Note No software project is ever finished. 


Semiautomatic 

Here is an extra credit mini -project [hat you may like to try. It gives you some appreciation for how hard 
your Arduino works to make things look easy and make you, as an Arduino developer, look good. 


Caution Improper use of the commands used in these exercises can render your Arduino inoperable. If you 
accidentally overwrite the Arduino bootloader (a distinct possib-ility). you need a dedicated device programmer, 
such as an Atmel STK500, ARVISP mkll, AYR Dragon, or other, working Arduino to replace it. 


You need a plain-text editor or programmer's editor. The editor in the Arduino software thinks 
you're writing an Arduino sketch and automatically fixes any file-naming mistakes you may make, such 
as ad ding a . c file extension. In Windows, you can use Notepad. On a Mae, you tan use TextEdit, In 
Linux, gedit or GNU nano will work. You also need access to the command line. 

All of the rest of the software that you need for these exercises is provided In the standard Arduino 
download package. It may be necessary for you to add the location of the A VR -specific tools to your 
system's path. The Location will vary, depending on where you decided to place the Arduino software on 
your machine: for example, ^Arduino installation folders /hardware /tools/ a vr /bln. 

On Windows systems, place a copy of the avrdude configuration file lavrdudc, conf) in that same 
d irec 1 0 ry. The c o n flgu ration file is u sually fo u nd i n < Ard u lmo in s ta flat ion 

folder>/ hardware/ tools/a vr /etc. TIils allows you to use the avrdude utility to program your Arduino 
without having to specify the location of the configuration file on the command line every time. See the 
included avrdude documentation in < Arduino installation fold er > /hard ware /tool s/avr/ doc /avrdude 
for more Information. 


Blinking in C 

Let's blink that LED again, hut this time let’s do it old school. In C. First, enter the program exactly as you 
see it in Listing 1-7. The inner workings of the AVR are revealed in Chapter :'i. 3 : nr now, this section 
glosses over some of the details to illustraie the software process. 
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Listing 2” 7 . Blink In C 
ffinclude <avr/io.hs 
int main{vc£d) { 
long i; 

WIRE = l«i; if PBS/Di} is an output 
whiie(l) { 

PORTE = 1«5; ft LED is on 

for(i =0; i < 100 000; i++) ; fi delay 

PORTE - Q«5; 7/ LED is iff 

for(i = 0; i < 100000; i++); // delay 

} 

I 

The# Include <av:r/io.,h> comp tier directive reads In a long list of predefined values that pertain to 
your specific processor. These Include the names and addresses of the 1YO ports (DOfeB . PORTE} tltat are 
referenced In the program. The processor is Identified Jit a comm and- line option passed to the compiler. 

The long i; Js a long Integer declaration, which reserves a spot for a 32-blt value. This value is used 
us a counter to kill some time. 

The l«S notation represents a binary 1 shifted Eeft 5 times. This 1s only one of many ways to 
represent this value using C. You can also use binary notation ObOOlGOOOQ. hexadecimal 0x20. or 
decimal 52. 

Name your new C source file blink, t, and save It In a convenient location. Now open a command- 
line window and navigate to this location. Enter the following command to compile this simple 
program: 

avr-gtc -i>5iti£u=ati*ega}2fl:p blink, c -a blink. o 

That’s a lowercase letter o, not a zero. If all goes well, you're rewarded with nothing hut another 
comm and -line prompt. Otherwise, some possibly enigmatic error messages may pop up. These error 
messages usually state the offending line number where a problem was found. Start with the first 
message, if there Is more than one, because a single syntax error can cascade into a veritable avalanche 
of error messages. 

Assuming everything goes well, the avr-gee compiler reads your source file, converts It into machine 
language instructions specifically for the ATmega32fiP ithe -mn , icu=ath , iega32Bp command-line option) and 
writes it out to a hie called blink .o, an object hie. Object files contains Lots of information, such as 
debugging symbols and other useful Udhits, in addition to the actual machine language Instructions you 
want to send to your Ardutno. 

You no w need to convert this object file Into a blitary Image file that you can program using the 
avrdude utility. This conversion is accomplished with the avr^objeupy utility, which speaks a variety of 
object-file dialects. Type this command to perform the conversion: 

avr-objeopy -0 Ihex blink. o blink. hex 

That’s a capital letter f> r not a zero. 

Now you have a file suitable for uploading to the Ardulno Uno. You use the avrdude utility to send 
the bits over the wire to the Ardulno. Like this: 

avrdude -p atmegajZEp -c slk^GOvl -P -U flashrwiblink.hex:! 
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The avrdude command syntax is a hit more complex than the previous commands you've used. Let’s 
look at each of Lite options and sec what they do. 

* -pa tmega 3 2 G p : Te Us a v rd ude what kin d of clii p yo u wan 1 to prog ram . Thl s Is 
similar to the -asiticu option for the avr-gee compiler. Different AVR chips use 
slightly different programming algorithms, and avrdude needs to know which one 
to use. 

» -e stk$ 00 vl: Indicates that the STKliiOO version L protocol Ls to be used to 

negotiate the programming of the chip. This is the protocol spoken by the Arduino 
bootloader. 

* -P \\.\CWli: Tells avrdude which serial port to use. Vour serial port will most 
likely he different. The \A.\ gibberish ls needed under Windows* for some reason, 
after you’ve exceeded the single-digit COM ports ( 1 - 9 ). 

* -U flash:*: blink. hex :i: The complete memory programming Instruction, 
pointing out the memory area of interest [the flash program memory), a (i/fnr 
write, the file name (blink, hex), and tltc file format (i - Intel HEX format). 


Caution The avrdude utility is also capable of rewriting the configuration fuses that currently protect the 
bootloader from being accidentally erased. Don’t mess with the configuration fuses until you really, really know 
what you're doing. You need a dedicated device programmer to recover from such a mistake. The good news is 
that the bootloader isn’t capable of overwriting -itself. Decide ahead of time how you want to Jeam this lesson. 


The avrdude utility spits nut a long series of statements during the programming of the chip, which 
usually looks Like Listing 2 -fi. 

Lifting 2 -S. Quip tn of the avrdude Utility 

avrdude: AVB device initial! red and ready to accept instructions 

Beading | | 100% O.OQS 

avrdude: device signature = Oxle 95 Crf 
avrdude: reading input file "blink. hex" 
avrdude: writing flash (292 bytes}: 

writing | | 100% 0.07s 

avrdude: 292 bytes of flash written 
avrdude: verifying flash memory against blink. hex: 
avrdude: load data flash Jala fro* input file blink. hex: 
avrdude: input file blink. hex contains 292 bytes 
avrdude: reading un-chip flash data: 
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Heading | | 100 % 0.05s 

avrdude: verifying ... 

avrdude: 292 bytes of flash verified 

avrdude: safemode: Puses UK 

avrdude done. Thank you. 

O' everyth lag has gone according id plan, your Arduino should be Hashing its LED at you right now. 
The flash rare should be a little faster titan the Blink example sketch. This lets you know that you're 
officially old school. 


Going Further 

Even though your fingers are probably exhausted from all tills typing, try to hear in mind that your PC is 
still doing most of the work. You can lighten your load a Utile by including the three previously 
mentioned commands ( a vr -gee -«aciJ=atmcga32Sp blink. c -a blink. 0 , avr-objeepy -D ibex blink. 0 
blink. hex, avrdude -p at*ega32&p- -c stkSOQvl -P \\.\C0Mil -11 flash :w: blink. hex: i} in a batch file. 

An even better alternative is to use the make utility, which has been specifically designed to help 
automate the programming development cycle. A version of the make utility is provided in < Arduino 
installation f older > /hardware/ tool s/avr>ut i Is /bin. You need to also add this to your path* unless 
you want to type that entire path in every time (which seems like It would defeat the purpose of trying to 
making things easier). 

Chapter 1 L contains more information about setting up your projects 10 use the make utility. 


Summary 

By now, you should have a good Idea of just how much software is involved In even the simplest Arduino 
projects. That LCD doesn't blink itself! 

Next up, Chapter 3 dives headlong into the heart of the classic Arduino, the At me! AYR 
microcontroller. 
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Let's get to know ihe little computer chip at [he heart of your Ard uhio. You start on the outside and work 
your way in, with a brief took at the origins and background of [he AVR Eine. 

Chapter 1 spent a little time talking about the AVR, mostly as a single component within a larger 
system. Jim what a component! There's an entire world inside [hat little chip. To really be able to take 
advantage of the potential of your Arduino in your past, present and future Ard ulna projects, you need a 
good understanding of how tills part works, what it can do, and how to make It do it. It all starts here. 
Remember, your Arduino Is "just an AVR development hoard.” 

The Arduino Team has taken elaborate measures to hide the complexity of this device from the 
casual user. This is good when you’re first approaching the idea of physical computing or embedded 
development, but it becomes cumbersome and hindering once you’ve grasped the basic concepts. 

This chapter should serve as a good Introduction to the AVR. but it's by no means complete. After 
you've read and understood the material presented here, you should have a better appreciation of just 
how powerful the hidden, underlying computer within your Arduino can he, as well as where Its major 
limitations lie. You'll also know where to go for even more detailed information, which you may 
eventually need for more complex projects. 

Origins 

The AVR architecture was designed by two students on a cold, winter night. Well, it probably took more 
than one night, but the winter nights in Norway ate really king. 

Alf-Egi! Bogcn and Vegard Wollan developed a reduecd instruction set computer (RISC] architecture 
design while students at the Norwegian Institute of Technology in Trondheim, Norway. Both men are 
no w e m p In ycd by A t me L 1 n T ron d b eim . 

To this day, the official explanation from Atmel concerning the meaning nfthe acronym AVR Is that 
it means nothing in particular. Theories abound, the most popular postulating it stands for Alfand 
Vegard’s RISC. 


AVR Device Families 

The 6-bit AVR family from Atmel has several branches. The ATmega32fl at the heart of modern ArduLnos 
is a member of the ATmega family, but so Is the ATmega25SQ, the computer chip of the Arduino Mega. 
This could possibly lead to the Idea that one version is mega and the other one is somehow Eess than 
mega, when in truth they’re both technically ATmega. 
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There is also an AVR tiny family and a classic family. Additionally, Atmel has introduced a USB line 
(a member of which functions as [he USB aerial port adapter on Lite Arduino Una and Arduino Mega} 
and an enhanced XMega family, with higher clock speeds and more functionality. More specialized 
families continue to be developed by Atmel. 

Atmel has also designed and produced a .32-bit version of the AVR line. Imaginatively called the 
AVR32. h bears little resemblance to the B-hit AVR line that is used in the Arduino products and isn’t 
discussed here further. 

E:aeh product family addresses a different product sector. The ATmega family is a good blend of 
affordability and case of use. ThetlnyAYR family Is directed toward more simplistic or severely cost- 
constrained applications. The classic family consists of the original AVR offerings from Atmel, including 
the venerable AT90S1200 and AT9QSB515. The majority of the classic family has been discontinued, 
re placed w Lth b ig he r - performa nee a nd In w nr - power version s. 


When in Doubt: Product Datasheets 

This chapter is only an overview of the AVR architecture, with special emphasis on the ATmega32B and 
ATmega256fl devices. The fma] word on all things AVR lies within the product datasheets, which are 
freely available from the Atmel web site: 

* A Tmega328: www , a trse I , com/ dy n / res ou r ces/ pr u Ll_doeumen t s /doc a 2 7 1 , pdf 

* A Tmegn25 fit): www , at me 1 . tom/ d yn / resou r c c s / prod _d a c ument s / doc25 49 . p df 

Be sure to also Look for any applicable errata sheets on your particular device. Any machine as 
complex as the AVR microcontroller is going to have a few adjustments along tilt.- way. Each revision of 
the silicon has Incremental improvements, hug fixes, and documented workarounds that are collected 
and published by the manufacturer. 

You're encouraged to browse the datasheets as well as the detailed application notes that are 
available. They're an invaluable reference. The AVR Team at Atmel is constantly updating the available 
information and welcome comments and 3>ug reports from users. 

Device Packaging 

Inside every AVR device is a silicon chip that contains the actual electronics that perform all the duties of 
the microcontroller. That integrated circuit |1Q or chip Is then packaged in a plastic body with almost- 
mlcroscopic wires running from the edges of the chip to the package pins. Several packaging options are 
available for AVR devices, accommodating ti wide range of end-user applications. Mobile devices 
naturally put a premium on small size and low weight, whereas hobbyists generally prefer larger-formal 
parts [hat are easier to handle by hand. 


Through-Hole DIPs 

The most popular packaging option for the ATsnega328 chip is the plastic dual- Inline package (PDIP). 
The last two letters of the complete part number Indicate the packaging option and the temperature 
range. The typical AVR In a modern Arduino I/O Board is properly called the ATmega32BP-PU, 
indicating the PDIP package option and the industrial temperature range of -40 < '€ to (See Figure 3 
U This package variant has been used since [he earliest prototypes of the Arduino began circulating. 
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Figure jr-i, The A Tmega32SP in a plastic dual- inline package IPDIP). The chip is installed In a socket and 
can be carefully removed and reinstalled a limited number of times. Nose she cartons markings and 
indicators on the left end of the package. These orientation marks indicate the location of pin l. There are 
tteo ways so insert the chip into the socket, bat only one of them is interesting. 

The pins of the chip (or of its containing socket) are Installed through holes drilled through the 
printed circuit board (PCE5J substrate and soldered into place. These are referred to as through-hole 
parts. The holes that the component leads go through are plated with conductive metal, helping to both 
electrically and mechanically connect the part to the PC 8 after they're soldered Into place. 


Surface -Mount Devices (SMBs) 

Due to a temporary shortage of devices available In the PDIP format, the Ardulno Team released an 
alternate PCB design for the Arduino Uno that used a surface -mount device (SMD) and called it the 
Ardulno Uno SMD. The SMD version of the PCB layout artfully allows for one of two different SMD 
package sizes to be populated on the PCD: the 7mm x 7mm Thin Profile Plastic Quad Flat Pack (TQFPl or 
the 5mm x 5mm Micro Lead Frame Package (MLF). (See Figure 3-2.) 
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P'igurtt 3-2. The Arduino U n o HMD teas designed to accept either of two different surface-mount device 
(SMD) packaging variations of the ATmega32H integrated circuit. The smaller of the two PCB footprints, 
the Micro Lead Frame Package (MLF), is nested within the larger Thin Profile Plastic Quad Flat Pack 
(TQFP). The silicon chip within the plastic package is smaller still. 

Other packages are available for the ATmega326 r including the tiny 4mm x 4mm Thermally 
Enhanced Plastic Very Thin Quad Flat Wo Lead Package [VQFN] and the Ultra Thin Fine-Pitch Dali Grid 
Array Package (UFliGA), also measuring 4 mm x 4mm .These wee packages see use in the most space- 
restricted applications,, such as mobile devices. 


Extra Pins 

Some of the packages for the ATmega32B have 28 pins (the PD3P and VQFN packages), and others have 
32 pins (the TQFP, UFBGA, and .MLF packages]. 

The four extra pins on lire higher -pin count packages are used as duplicate power and ground 
connections as well as two additional analog-to-digital converter [ADC) inputs, ADC6 and ADC7. 
Another way of looking at this Is that on the packages with fewer pins p ADC6and ADC7 aren't 
pit tried -out. 

Some Arduino (or Arduino- compatible) hoard designers provide extra connections for these extra 
ADC inputs, and others don't. The official Arduino Uno SMD, sadly, doesn't (at least lit Revision 1 R1 and 
Revision 2 R2 hoards]. The Seecdstudio Seeedulno does [see Figure 3-3). This show's the opportunity of 
open source projects to add additional features without having to start over front scratch with a new 
design. 
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Figure 3-3. The Seeed.stu.dio Seeeduino uses the SMD torsion of t fie ATmega32& chip, and rotues the extra 
ADCS and ADC? inputs so connector pins near Use power expansion connector flGJ. Photo by Seeedsindio. 
Used with permission. 


Pin Descriptions 

The pins of the device, no matter what the package variation, are the microcontroller's electrical and 
mechanical collection to the outside world. Some pins, such as the power supply connections V., and 
ground iGMD), have only a single function. Most of the rest of the pins have at least two and sometimes 
more possible functions. These functions are determined by a combination of device configuration fuse 
settings and software. See the “Configuration Puses” section laier so this chapter. 


Power Fins 

The AT mega family runs on direct-current (DCj electrical power, In the range of i.GV to 5.5V. The higher 
voltage supplies allow for faster clock rates. See Table 3-1. 
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Tub f# j -1 r ,4 Tm ega32S S u pply Voltage and Clock Fret] nets cy 


Maximum Frequency 

Minimum Supply Voltage 


IMHi 

l.BV 


IQMHz 

2.7 V 


20MHz 

4.5 V 



Curiously, the ATmega256G on the Arduino Mega lias only a single frequency /voltage rating of 0- 
IGMEIz at 4.SV-S.SV. No lower-voltage speed ratings are provided jo the Atmel datasheet. 


Digital and Analog Power Supplies 

There are two distinct power circuits within the ATmega chips. One is Ihe digital supply voltage, referred 
to as VCC or V . This is the power supply that provides the CPU core, memories, and dlgitat peripherals 
with power. The other is the supply for the analog portions of the chip. Including the ADC and the 
analog comparator (AC). The analog power supply pin Is called A VCC or AV , . Both V, .and AV, , should 
he supplied with the same voltage, 

Separate supply pins are used on the ATmega chips so that additional power-supply filtering can be 
provided for the analog section when low- noise or high -accuracy analog readings are required. This 
gives the circuit designer the opportunity to reduce the power glitches and high-frequency noise that are 
generated hy the ATmega’s digital circuitry. 

Th e 2 ti- p hi package s of t h e AT m ega3 2 S ha ve a sing le V pin, a. single AV, p in , an d t wo ft N D p Ins . 
The 32-pin packages have two V, , pins, a single AV, , pin, and three ftM'J pins. The 100- pin ATrnega2560 
has four V,, pins, flveGND pins, and a single AV,, supply pin. 


Note The AV K power supply must, be connected, even if no analog circuit functions are used. 


The terms VCC (or V,, ) and CM D don't accurately describe the power-supply pins. These terms are a 
hold-over from previous semiconductor technologies, such as Transistor-Transistor -Logic (TTL), where 
the input and output transistor drivers were arranged in a common collector geometry. V 1( , therefore, 
was the voltage of the common collector. 

The AVR microcontroller family Is based on a low-power Complementary Metal-Oxide 
Semiconductor (CMOS) transistor technology. Cam pigmentary means that both N -channel and P- 
channel transistors are directly implemented in the silicon. MOS transistors don't have collectors, 
emitters, or bases. They have, instead, a drain, source, and gate term ina l r which only loosely correspond 
with the terminals of the bipolar Junction transistors (BJTs) of older Integrated circuits. The correct 
terminology for the power and ground pins of a CMOS device are V „ anil V . , respectively. 
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Analog Reference (AREF) 

The analog reference (AREF) pin can be used In a variety of ways. It's connected to the reference input of 
the analog- to -digital converter (ADC] peripheral. The reference input voltage represents the high end of 
the voltage measurement range. The low end of the voltage measurement range Is ground, for single- 
ended ADC conversions. The ATmega32B only supports single -ended ADC conversions, whereas the 
ATmega2560 Iras the ability to make differential voltage measurements across multiple inputs. The ADC 
takes an analog reading of one of the available analog Input pins and compares it to the analog reference 
input. The resulting numeric value Is a ratio of the input value to the analog reference. 

Through software, the ADC can select several sources for Its analog reference. These sources are an 
external voltage source applied to tire AREF pin, tire AV analog power supply i or an Internal voltage 
reference. On the ATmega32S, the internal voltage reference Is approximately 1.1V. On tire ATmega256G. 
the internal voltage reference Is selectable between l.LV or 2.56V. 

If you use AV m or one of the internal voltage references, you can attach an external decoupling 
capacitor between the AREF pin and ground, thus Increasing the stability of the reference voltage. 

Another option Is to use an external voltage reference source. This option is used in several 
circumstances: for example, when you require a more accurate reference or need a particular voltage. In 
this case, it's Important not to select via software any of the other reference options, because doing so 
would directly connect the Internal and external voltage sources. 

The Ardulno IJno connects the AREF pin to the power expansion connector, making it available to 
users. The Ardulno Mega. 2560 does the same thing hut also connects a ti. I |iF ( ] OGnF) capacitor 
(reference designator C3) between AREF and ground. 


RESET 

The RESET pin provides a mechanism to reset or restart the microcontroller. The bar over the name 
indicates that it's an active low Input, meaning that the RESET function occurs when the input is 
taken low. 

The ATmega256Q has a dedicated RESET Input, pin 30. On the ATmega320, tite RESET input is 
multiplexed with the general-purpose DO pin PCfi. The function of the pin is determined by the setting 
of the reset disable fRSTDISBU configuration fuse. When this fuse Is programmed, the normal reset 
function of the pin Is disabled. You can then use the pin as a general-purpose 1(0 pin. Port C, bit 0 (PCS). 
The chip can still he reset from a variety of sources, including the power-on reset (POR'J detector, the 
hrown-out reset (BOR) detector, or the Watchdog system reset. 


Caution Disabling the external RESET pin function prevents reprog ram mi rag of the device by either the Arduino 
bootloader using Auto-Reset or an ISP device programmer. Consider this the I/D pin of last resort. 


You should note that the RESET pin is designed to withstand higher- than- normal voltage Inputs. 
This Is because the RESET pin Is also used to signal the chip to enter a programming made. Bringing tire 
RESET lint- low and keeping It low causes the chip to enter In-System Programming flSP) mode, or Low 
Voltage Serial Programming (LVSP) mode. Raising the RESET pin to approximately 12V ( 1 1.5V to 12.5V) 
causes the chip to enter High Voltage Parallel Programming (IIVPP] mode. Because of this special 
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function, the RESET pin Lacks the protective clamping circuitry that Is present on all other pins, and it's 
therefore more susceptible to damage from static discharge. 


XTALf and XTAL2 

The XTA1.1 and XTAL2 pins are the Input to and output From the internal inverting oscillator amplifier, 
respectively. You can also use XTALI as the Input in the internal clock circuit, If an external cEock source 
is available. 

These pins are normally connected to a quartz crystal to form the time-base of the microcontroller's 
clock system. The abbreviation XTAL traditionally refers to a crystal of some sort. However, you can also 
use ti ceramic resonator. Ceramic resonators perform much the same function as quarts crystals but are 
generally less accurate and cost Less. 

The system clock is the heartbeat of the entire microcontroller. Other clock options arc available 
that don't require the use of the XTAL pins. See the “Clock Sources" section later In this chapter for 
more details. 

The KKl-pin ATmega2S60 has dedicated XTAL. L and XTAL2 pins. The ATmega32B multiplexes the 
XTALI and XTAL2 pins with the general-purpose I/O port pins PBtiand PB7. A typical Arduino circuit 
uses either a quartz crystal (Arduino Duemilanoveand earlier) ora ceramic resonator (Arduino Uno) to 
provide a highly accurate time base for the system. The choice between using HO port pins and clock 
pins is a by-product of the CKSGLO-3 clock selection configuration fuses. When the quartz crystal or 
ceramic resonator option is selected, PBfrand PB7 can no longer be used for general-purpose I/O. 


General-Purpose Input/Output (I/O) Ports 

You've covered all the specific -purpose pins on both the ATmega32& and the ATmega2S60 (power and 
ground connections and A REF, RESET, and XTAL pins). Each and every one of the remaining pins can he 
used as a general-purpose input /output pin, among (many) other things. 

The I/O ports on the AVR are quite versatile. Each port can have up to eight pins associated with it. 
Each pin within Lhe port can be configured as an Input or an output. For more information about the 
general -purpose I/O porLs, see the "Internal Peripherals" section. 


Alternate Pin Functions 

Everyone of the general-purpose I/O plnson the ATmega32fl and all hut three of the pins of the 
AT mega 2 560 (PJ7, PLfi, and PL.7) performs an alternate function, usually associated with one or more of 
the other internal peripherals. The alternate pin functions of the ATmega328 are outlined in Table 1 - 2 . 
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TithU 3-2 r Alternate Pin Functions of the ATmega328 


Pin Number 

I/O Pin 

Function 

Description 

DIP-2H 

TQFP-32 

14 

12 

PEL) 


Digital pin £ 

CLKO 

Divided system clock. output 

ICP1 

Timer/ counter 1 input capture Input 

PCINTO 

Pin-change interrupt [) 

15 

13 

PEA 

D9 

Digital pin h (PWM capable] 

OC1A 

Timer/ counter 1 output compare snatch A output 

PCINT1 

Pin-change interrupt 1 

16 

M 

PB2 

DIO 

Digital pm 10 {PWM capable] 

OC1B 

Timer/ counter 1 output compare match 31 output 

-SS 

St 3 ! bus master/slave select 

PCINT2 

Pin-change interrupt 2 

17 

15 

PB3 

Dll 

Digital pin 11 {PWM capable) 

0C2A 

Timer /counter 2 output compare snatch A output 

MOSI 

SPI bus master output, slave input (ISP) 

PC1NT3 

Pin-change interrupt 3 

IB 

16 

PR-1 

D 12 

Digital pin 12 

M ISO 

SPI bus master input, stave output (3SP> 

PCINT4 

Pin-change interrupt 4 
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Continued 


Pin Number 

I/O Pin 

Function 

Description 

DIP -2fi 

TQFP-32 

19 

17 

PBS 

D 13 

Digital pin 13 (LCD) 

SCK 

SP3 bus master clock Input (ISP) 

PCINTS 

Pin-change interrupt S 

9 

7 

PBS 

XTAL1 

Quartz crystal or ceramic resonator Input, external 
clock input 

TOSC1 

Timer/ counter 2 oscillator input 

PCINTfi 

Pin-change interrupt 6 

19 

e 

PB7 

XTAL2 

Quartz crystal or ceramic resonator output 

TOSCi 

Timer /counter 2 oscillator output 

PCINT7 

Pin-change interrupt 7 

23 

23 

PC9 

AO 

AD C9 . analog input 9 

PCINTfi 

Pin-change interrupt & 

24 

24 

PCI 

Ai 

ADCl, analog input 1 

PCINT9 

Pin-change interrupt 9 

23 

23 

PC2 

A2 

ADC2, analog input 2 

PCI NT 10 

Pin-change interrupt 19 

26 

26 

PC3 

A3 

ADC3, analog Input 3 

PCINT1I 

Pin-change interrupt li 
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Pin Number 

I/O Pin 

Function 

Description 

dip -ia 

TQFP-32 

27 

27 

PC4 

A4 

ADC4, analog Input 4 

SDA 

I'C/TWI stria] bus data Input /out put line 

PC1NT12 

Pin-change interrupt 12 

2R 

2ft 

PCS 

AS 

ADCS, analog Input 5 

SCL 

rC/TVVI serial bus clock line 

PCI NT 13 

Pin-change interrupt 13 

1 

29 

PCS 

-RESET 

Reset input, active low 

PCINT14 

Pin-change interrupt 14 

2 

30 

PDO 

DO 

Digital pin 0 

RXD 

USART serial input 

PCINTlti 

Pin-change interrupt 16 

3 

31 

PD 1 

Di 

Digital pin 1 

TXD 

LJSART serial output 

PCINT17 

Pin-change interrupt 17 

4 

32 

PD2 

D2 

Digital pin 2 

INTO 

External Interrupt 0 

PCINTifl 

Phi-change interrupt 1ft 

5 

1 

PD3 

D3 

Digital pin 3 (PWM capable] 

OC2E3 

Timer /counter 2 output compare match 11 output 

INTI 

External interrupt 1 

PCINT1S 

Pin-chauge interrupt 1ft 
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Continued 


Pin Number 

I/O Pin 

Function 

Description 

DIP-21) 

TQFP-32 

6 

2 

PD4 

! — ! 

4 ^ 

Digital pin 4 

XCK 

(J.SART external clock 

TO 

Tim er / co u n i er 0 exrer n at co u n ter i n put 

PC1NT20 

Pin-change interrupt 20 

11 

& 

PD5 

DS 

Digital pin 5 fPWM capable} 

OCOB 

Timer /counter 0 output compare match B output 

T 1 

Timer/ counter 1 external counter input 

PCINT21 

Pin-change interrupt 21 

12 

id 

PDti 

D6 

Digital pin 6 (PVVM capable) 

OCOA 

Timer /counter 0 output compare match A output 

AINU 

Analog comparator Input 0 (positive) 

PGINT22 

Pin-change interrupt 22 

13 

n 

PD? 

D7 

Digital pin 7 

AIM 

Analog comparator input 1 (negative) 

PCINT23 

Pin-change interrupt 23 


AVR Core 

Refer back to Figure I -4 Jit Chapter l for a simplified block diagram of the AT mega326. At Its center is the 
AVR Core, containing the arithmetic logic unit (ALU} that performs mathematical and logic calculations, 
a set of 32 general-purpose 8-blt registers, a status register (SREG), the program counter (PCI. an 
instruction decoder, and Interfaces to die built-in memory arrays and rite on-hoard peripherals. See 
Figure 3-3. 
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J?l&Ure 3-3. The AVR C. ate contains i he essential components of the AVR central processing unit (CPU). It's 
tightly integrated Into the rest of the microcontroller. 


Note The ATmegaZ56Q also has an external memory (XMEMj interface, allowing up to 64KB ot additional 
SRAM or other memory -mapped peripherals to be added to the system. 


After the chip is reset, the PC is set to zero. The first Instruction Is fetched from a location in rite 
program memory (which can change based on settings in the MCU Control Register), which is called the 
reset vector, it generally contains an Instruction to jump (transfer execution) to the proper location in the 
code to begin any initialization processes needed, and then onward through to the application program. 
These details are usually handled by the compiler software. 


Note The term pectoris used throughout the Atmel AVR documentation. Vectors are generally pointers to 
specific locations (addresses). The AVR vector table contains a list of executable instructions, but these 
instructions can be [and usually are) unconditional branch instructions that encode a particular destination 
address. 


51 


Chapter 3 atmel avr 


The next several locations at the beginning of the program memory are the interrupt vectors. 
Interrupts are events that occur during program execution that cause the chip to stop what it's doing, 
save its place, execute a specific hit of codes and then return the origins L program as if nothing ever 
happened. Table 3-3 lists the reset vector and ail the interrupt vectors available on the ATmega32S. The 
ATmega256Cl has a similar but longer vector table, due to the larger number of built-in peripherals. 

table 3-3. Vector Table for theATmega32& 


Vector 

Address 

Interrupt 

Description 

i 

0x0000 

RESET 

Power-on reset, brown-out reset, watchdog reset, RESET pin 

2 

9x0002 

INTO 

External interrupt 0 

3 

0x0004 

3NTI 

External interrupt 1 

A 

0x0000 

PC1NT0 

Pin -change Interrupt 0 

5 

0x0008 

PCINTi 

Pin -change Interrupt 1 

6 

OxOOOA 

PCINT2 

Pin -change interrupt 2 

7 

OxOOOC 

WDT 

Watchdog timer 

fi 

OxOOOE 

TIM E.R2_COMP A 

Timer/counter 2 compare match A 

& 

0x0010 

TIME R2_CGM PB 

Timer/ counter 2 compare match IS 

11) 

0x0012 

TIMER2QVF 

Timer/ counter 2 overflow 

11 

0x0014 

TIMERl. CAP 

Timer/ counter 1 capture 

L2 

0x0016 

TI M E R 1 _COM: PA 

Timer/ counter L compare match A 

13 

0x0016 

TIMERl COM PB 

Timer/ counter 1 compare match 13 

14 

0x001 A 

TIMER_OVF 

Timer/ counter 1 overflow 

1 5 

0x00 1C 

TIM ER0_COM PA 

Timer /counter 0 compare match A 

16 

0x00 IE 

TIM ER0_COMPB 

Timer/ co unterO compare match B 

17 

0x0020 

TIM ER0 OVF 

Timer/ counter 0 overflow 
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Vector 

Address 

interrupt 

Description 

is 

0x9022 

SPI 

SPI serial transfer complete 

19 

0x0024 

IJSAHT_RX 

US ART receive complete 

20 

0x0026 

IJSARTJJDRE 

USART data register empty 

2 1 

0x0028 

US ART. TX 

U S A RT trans tnl t com pie te 

22 

Cx002A 

ADC 

Ana log-iu- d igl tal co n versi o n com pic tc 

23 

0x002C 

EE_READY 

E EPROM ready 

24 

0x002 E 

ANA_COMP 

Analog comparator 

25 

0x0036 

TW1 

Two -wire interface (TC) event 

26 

0x0032 

SPM READY 

Self- p rograrn m Ing even t 


See Chapter 7 for examples of Slow to use hardware Interrupts in Arduinn sketches. 

You can enable or disable (mask) individual interrupts in software. There Isa master interrupt 
enable bit In the SREG (bit 7) called the Global Interrupt Enable bit, or simply I. When this hit is set to a 
l r interrupts can occur. When the bit is cleared, no Interrupts occur. The Global Interrupt Ena hie bit is 
cleared by default. 

An interesting design decision in the AVR architecture is that when an Interrupt occurs and program 
execution jumps to the designated interrupt handler routine, the Global Interrupt Enable hit 111 is 
cleared. This prevents any further interrupts from being handled. If you need nested interrupts 
(interrupts within Interrupts), you must set the I bit explicitly within the interrupt handler routine. 
Specific machine-language instructions are allocated for setting and clearing the 3 bit within SREG: S£i 
for Set Global Interrupt Flag (opcode 0x9478) and CLI for Clear Global Interrupt Flag (opcode Qx94F8). 
There is also a specific machine-language instruction for returning from an Interrupt handler, 
enigmatically called RET I nr Return from Interrupt (opcode 0x9518), This In struct Ion automatically re- 
enables the Global Interrupt Enable bit when executed. 

The SEI and C L I instructions are specific codings of the more general -purpose USET (Eli Set In SREG) 
and fiCLk |Eit Clear In SREG) Instructions. Having the ability to quickly and easily set and clear Individual 
hi is within the SREG was considered important enough to warrant their own instructions. You can also 
test the SREG bits with a variety of conditional branch Instructions. If the appropriate conditions are 
met — for example, an arithmetic overflow occurs, or the result of a calculation is negative — then the PG 
is reloaded with a new value, effectively causing the CPU to jump to a new location In the program 
memory. The hits in the SREG are listed In Table 3-4. 
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Tab!* 3-4 r Status Register (SREG) Bits 


Bit 

Name 

Description 

D 

c 

Carry 

1 

7. 

Zero 

2 

N 

Negative 

i 

V 

Overflow 

4 

S 

Sign 

5 

II 

11a If- carry 

6 

T 

Test lilt 

7 

I 

Global interrupt enable 


The C, Z. hT, V, and 1 1 bLis are set or cleared depending on the remit of certain arithmetic or logical 
instructions. The S hit is set if either the N or V flag Is set, hut not both. 

The T bit can be manipulated by specific instructions, &LDand B£T (Bit l.oad and Bit Store, 
respectively). These Instructions allow Individual bits within the registers to be moved and copied. You 
can test the value of theT hit using the conditional branch instructions BRTC and &R 1 S [Branch If T bit 
Cleared and Branch ifT BJtSei. respectively). 


Clock Sources 

The timing of all internal functions within your Ardubto is controlled by the system clock. The standard 
Arduino circuit uses either an external quartz crystal or a ceramic resonator to provide the fundamental 
frequency that drives the rest of the system. Tills is only one of several clock options available with the 
AVR: microcontroller. 

The clock systems of the ATmega32fi and ATmega256fl are effectively identical. Both have an on- 
board oscillator whose frequency can beset by an external crystal or resonator. This oscillator has two 
modes of operation. The low-power mode uses the- least amount of power but Is unable to drive 
additional clock signals external to the device. The full-swing mode increases power usage. 

Additionally, both devices have the option of being clocked from an external signal. If a suitable 
signal is already available, this allows the device to be clocked without a dedicated timing component. 

T b ere areal so t wo RC oscilla tor ci reu i is a va iiab le h w Ith f req uenc les o f Si .0 M 1 1 z a n d 1 2ftK i i ?., 
respectively. The SMI Iz oscillator can he calibrated {adjusted] in software, hut it Isn't as accuraicasa 
quartz crystal or even a ceramic resonator. 

A system clock p re scaler Is available to divide the system clock hv Integer powers of two from l : I to 
1:256. Slowing the system clock reduces the amount of power required. 

If the main system clock Is generated by one of the calibrated resistor/capacitor IRC] oscillators, you 
can use an external low- frequency clock crystal (typically 22 KHz) to drive Timer/ counter 2 In a real-time 
clock application. The timer peripheral can continue to run and keep accurate time even when the main 
processor shuts down in sleep or power-saving mode. 
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Address Spaces 

The AVR Core lias access to several arrays of memory and I/O devices. The AVR architecture itself is 
based on a Harvard architecture, where the program and data memories are separated, as opposed to a 
Von Neumann architecture, where the two memories are intermingled, overlapping, and 
interchangeable. 


Program Memory 

Tite actual machine-language Instructions for the processor to execute arc stored in the program 
memory*. On AVR devices, this memory Is implemented as a 16-bit wide array of in-system 
reprogrammable flash memory. Because the program memory is also self- reprogrammable, a certain 
amount of data can be stored in It, but the programming time and limited number of writes Limit its 
usefulness for transient data storage. 

This program memory section is sometimes referred to as ROW, or read-only memory. This is yet 
another anachronism that no longer accurately describes the present function or capabilities. The term 
ROM was often used to describe the permanent nr non-volatile bit codings that persisted in a system’s 
memory even during power outages. This term was used to differentiate this type of memory from RAM, 
or ftarnfont-occesi memory, yet another misnomer used to identify rewritable or volatile memory devices. 
The flash memory technology used by Atmel in its AVR products as well as other semiconductor devices 
has ail the advantages of non- volatility while being easily reprogrammable without complex or 
expensive device programming hardware. 

Ardulno software iak.es advantage of the AVRs self-programmable nature by implementing a 
bootloader, a small piece of resident firmware that communicates with the host. PC and allows compiled 
sketches to be sent front the PC and stored in die program memory of the AVR. This eliminates the need 
for any sort of special device- programming hardware. 

The PC Is used to keep track of the AVR’s place within a program. On reset, the PC Is cleared to alt 
zeros. Execution begins with the reset vector, which is almost always the unconditional branch 
instruction RW (Relative Jump}. The destination of the Jump Ls the beginning of the program- 
initialization code. 

The Atmel datasheets suggest that the contents of the program memory should he stable for many 
years. 


Data Memory 

The microcontroller usually needs to store variables and changing data during the course of the 
program's execution. This memory is implemented In the AVR as static, random-access memory 
(SRAM). Technically, all the memory arrays within tilt- microcontroller are random access, in that any 
individual memory location can be directly accessed. The memory array is based on itaffebit ceils that 
require no active clock signal m retain their contents, as opposed to dynamic RAM cells That require 
periodic refresh. The SRAM designation is yet another hold-over from previous memory technologies. 

The SRAM memory array maintains its data integrity as long as power is applied to the chip. When 
the power has been removed, however, the status of the memory contents is indeterminate. lt r s not 
prudent to assume that SRAM contents take on any special value (such as all zeros) afLer power has been 
applied. The C programming language, on which the Ardulno programming language is based, takes 
steps to ensure that uninitialized data Isn't used in a way that assumes an expected value. 

The ATmega32S chip has 2KB of SRAM, and the ATmega2560 has B KB of SRAM. The ATmega256‘0 
can also address external SRAM using its XM EM peripheral. This peripheral converts some of the 
available 3/0 ports Into address and data buses, along with dedicated control lines. Typically, you can 
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add up to 64 KB of additional SRAM to the ATmega2!>[SG chip, with more being possible if you implement 
ll bon k-swltch ing a r rangem en t. 


Registers 

Every AVR chip from the smallest to the largest has a generous general-purpose register file. There are 32 
registers In the file, numbered Rfl to R3i. Most of the arithmetic aod logical instructions of the C 3 > IJ trait 
read and write to the Individual registers within the register file directly* often In only one clock cycle. 
Even the smallest tinyAVR devices with no built-in SRAM have these registers at their disposal, This large 
register array permits fast and complex algorithms to execute quickly, without having to copy data back 
and forth from the SRAM memory. 

Six of the registers have a special use. They can be combined to form three Ifi-blt index pointers to 
the data space. These Index registers are called X. V, and Z. TheX index register Is composed of registers 
R26 (low il bits] and R27 (high f! bits). The Y index register is composed of R28 and R29, and the Z index 
register Is composed ofRi'ib and R3L. 

The AVR Core has many useful and complex addressing modes for accessing both program memory 
and data memory spaces. These addressing modes are encoded Into the Individual machine- language 
instructions tbai arc executed by the AVR Core. For example, a single instruction can Load an fl-bli 
Immediate value fa form of constant value) from the program memory and write it Into any one of the 
upper 16 registers In a single clock cycle. A variation of this instruction can copy a value from a specific 
SRAM location into a register, and vice versa. Building In complexity, instructions can use one of the X, 

Y, orZ Index registers as a data pointer, with optional displacement or offsets contained within the 
instruction added to the index register to form the effective address desired. It gets more complicated 
when you add post-increm en t or pre-decrement options* which modify the index register either before or 
after the operation. This is very handy when you’re iterating through arrays of data. 


Input/Output Registers 

The I/O address space is where all the internal peripherals are accessed. Each peripheral contains one 
or more registers whose constituent bit settings determine the behavior of the peripheral: for example, 
the baud-ratc setting of the serial port or the direction (input or output) of one of the general-purpose 
I/O pins. 

The SRAM, register file* and peripheral I/O registers are all contained within the data memory 
space, as opposed to the program memory space. This division of program and data permits more 
throughput* because separate buses and control lines are used to move data and program Instructions 
back and forth without interfering with each other, and is a performance advantage of the E Iarvard 
architecture used by the AVR. 


EEPR0M 

The ATmegaUSfi contains 1KB of electrically erasable, programmable read-only memory (EEPROM). The 
ATmegaZSeO has 4KB of EEPROM. Again, you see the residue of generations past lingering in Lite reod- 
ON/y portion of the admittedly conflicted name. It’s read-only, hut it's also programmable, somehow. 

Not only that* It’s electrically erasable (as opposed to optically erasable, a dim memory of semiconductor 
devices rbat bad transparent quartz windows over their chips, to allow amnesia -producing, 
forgetfulness-inducing ultraviolet light to enter and cleanse the memory array of old daLa}. 
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EEPROM is similar to the program memory,, except it's rated to endure many more write arid erase 
cycles. This makes it better suited for storing user-alterable configuration settings or other long-term 
data that needs to be non-volatile but easily modified. 

The EEPROM data can't be directly addressed by the AVR Core. Instead, the address of the desired 
EEPROM location is written to a special register, a bit Lit another EEPROM -related I/O register is set to 
cause a read operation to be performed, and then the EEPROM data can be read from yet another 
register. Writing to the EEPROM array is accomplished in a similar manner: an address is written to the 
EEPROM address register, the data to be written is copied to the EEPROM data register, and a slightly 
more complex bit-twiddling process is invoked. This more complex procedure helps guard against 
inadvertent EEPROM writes. 

The contents of an EEPROM byte are automatically erased prior to writing. The reading process is 
nearly instantaneous: the data is waiting to be read as soon as the address is set up and the read- strobe 
hit is engaged. The timing of the writing process is completely controlled by the on-board EEPROM 
logic. The write process takes approximately 3.3 ms (milliseconds) per byte. A user program can either 
monitor the status of the program -enable bit (which remains set until the write process is complete) nr 
set up an interrupt to let the processor know asynchronously when the process has completed. 


Configuration Fuses 

The configuration fuses control several operational aspects of the chip. This gives the devices a great 
deal of flexibility in how they can be used. The configuration fuses are normally read and written by an 
external device programmer. The chip can read its fuse setting and lock bits using the LPft Instruction 
(discussed shortly). It can also write to the bootloader lock bits [but none of the other configuration 
fuses) using the SPM instruction, 


Note The choice of tfie term /uses to describe the hardware configuration settings on the chip is an 
unfortunate one. Other manufacturers offer devices with fuses that can be programmed once and then never 
again. All the AVR configuration settings can be set. erased, and reprogrammed irmltiple times. Many people 
associate the word fuse with a disposable, one-time device. 


Both the ATmega32& and ATmega2560 have three fuse bytes: a high byte, a low byte, and an 
extended hyie. Each byte contains up to eight individual fuse settings. 


Cauti on Certain combinati ons of fuse settincs can renderycur AVR inoperah le ; or at I east inaccessible without 
specialized device-programming hardware. Always use Smart warnings or Fuse warnings when programming your 
AVR device directly. This isn't a concern when you 're using the Arduino bootloader and the standard Arduino 
programming software. 
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Instruction Set 

The collection of executable machine-language codes or instntctitnis form the AVR instruction set. The 
ATmega3£fl has 13 1 unique instructions, and the ATmega2560 has 1 35. The larger program memory 
space of the AT mega 2 5611 requires some additional Instructions. 


Note Ttie term reduced instruction set computer (RISC} is somewhat contusing, to say the least. It : s supposed 
to indicated that the complexity ot the instructions themselves is reduced, not that the instruction set, as a whole, 
has been reduced in size. Simplified executable instructions translate well into simplified silicon implementations, 
which often translates into smaller, faster, cheaper devices. Although it's possible to develop computers with very 
few executable instructions (a reduced set], they often prove to be ineffective in practice. 


Ardulno programmers don't need to know anything about the Instruction set of the AVR. The 
Arduino software completely handles the task of translating lire hu man -readable source code into the 
appropriate sequences of machine codes needed to accomplish the desired goat. 

Knowing more about lire Inner workings of the AVR Core will, however, give the advanced Ardulno 
programmer a decided advantage when approaching new coding challenges. Knowing the strengths and 
weaknesses of the internal machinery helps you take advantage of the strengths and avoid, when 
possible, the weaknesses. 


Machine Language Instructions 

AVR instructions are either 16 or 32 bits long. Most Instructions execute in a single cycle. The main 
Instructions fall Into four major categories, plus a small number of system -control Instructions. 


Arithmetic and Logic 

The arithmetic instructions perform very basic binary arithmetic, such as addition, subtraction, and 
multiplication. All of these instructions are performed by the arithmetic logic unit (ALU l within the AVR 
Core. Tire operands [numbers used in the calculations) are taken either from the register file or constant 
(immediate] values contained in the instructions themselves, and then processed by the ALU. The 
results are then stored back In the register file. 

The addition and subtraction Instructions work on a single byte (ft bits) of data at a time. The AVR 
implements both carry propagation and aero propagation, which considerably simplifies math on larger 
data types,, such as ifi- or 32-bit values. 

For example, to add an ft- bit value in one register (the source register, or Rr) to another fl-bli value Ln 
another register (the destination register, or Rd.l r yon use the ADD Rd, Rr instruction: 

aod rq, kt 

This instruction adds the contents of Rl to RO. Expressed algebraically, this is Ro = Ro + kt. This 
assumes the proper values for the addition were already present in RO and RL. You can read more about 
bow to get those values into the registers Ln the first place Lit the "Data Transfer” section of this chapter. 


CHAPTERS AT MEL AVR 


To add two 1 6- bit number together, four of the 8- bit registers are needed: two for the first addend 
and two for the second addend. Let's use R1:R0 (low byte in RO, high byte in Rl] for the first addend and 
R3:R2 for ilu.- second. The registers need not be adjacent or in any particular order: 

ADD Ro* fti ; add low bytes together - this sets the carry flag If necessary 

ADC Kl, fij ; add high bytes together with carry flag 

As you may have guessed, text after a semicolon (;) on the line Is considered a com mem by the 
assembler arid is ignored. 

Wore that the second instruction is ADC (Add with Carry). The first ADD Instruction properly 
disregarded any carry flag set from a previous calculation. You can extend this process for larger 
numbers by appending more ADC Instructions. Using all of the :iZ available registers ai once, a maximum 
of 12fl bJi values can be added or subtracted without having to stop, store, and fetch Intermediate values 
elsewhere. 

The multiplication Instructions take two 6-hlt operands and produce a IS-blt result. There are 
instructions for unsigned (.huL) and signed (MULS) multiplication, as well as for multiplying a signed value 
hvan unsigned value (hULSU). These instructions execute in two cycles. 


Note Signed values contain both a numeric sign (positive or negative) and a magnitude. Unsigned values 
contain only a magnitude and are considered to always be positive. It possible, don't mix signed and unsigned 
values. Strange things will happen. 


The additional math. Instructions INC and DEC allow a register to be incremented or decremented by 
one. Interestingly, these instructions don't affect the carry flag In the SR EG bul do affect all other llags. 
Tills was Intended to help simplify the Implementation of an integer loop counter within multiple- 
precision calculations. 

Logical operations work on the Individual hits within a register without considering them to 
represent a numeric value. The logical functions are often referred to as Boolean algebra* named after 
George Boole, the patron saint of ones and xeros. The simplest operations in logic are and, or, and nor. 


Caurti on Don’t confuse these logical 0 p erations at the machin a -I an g u ag 9 le vet with the lag ical operators i n the 
C language. The logical operations at the chip level are performed on all bits of the target registers simultaneously. 
These best correspond with the bit-wise operations of C. 


The easiest io explain Is not* sometimes called opposite or complement. The complement of 1 JsO, 
and the complement of 0 is 1. True (1) and False CD] are often used as operands in logical calculations. 
This relationship has a nice symmetry to It, which makes it easy to understand and remember. True Is 
the opposite of false, and false Is the opposite of true. If this sounds too ridiculously simple, just wait. 
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The and logical operator has two operands Instead of one. Let’s cal] them A and B. Tice result of the 
computation is called Y, so you can write V = A and B. The basic ru]e of and is that Y is true if A and B are 
true; otherwise Y is false. This also means that if either A or B U false, then Y must also be false. Table 3-5 
illustrates these relationships in a truth table, which lists all the possible combinations of Inputs and 
Lheir associated outputs. 

Table 3-5- Truth Table far the Logical and Function (True = t. False*. 0) 


A 

B 

Y 

0 

0 

0 

1 

0 

0 

0 

1 

0 

1 

1 

1 


The AND instruction performs the logical and function on all eight bits within a register. This is 
sometimes called bit-wise AND. For example, If RQ contains OxSF (orObOlQH 111 in binary] and Rl 
contains 0x33 (or OhOUl 1001 I In binary), then the result of AND kOj, 111 Is 0x13, or QbOOOlQOi 1 in binary. 
Note that the corresponding lilts In bath registers must be 1 for the result to be 1. See Table 3-0. 

Table $-6. Examples of the AND Instruction on fir) and Rl 



7 

6 

5 

4 

3 

2 

1 

0 

RO 

0 

l 

l) 

l 

L 

1 

1 

1 

Rl 

0 

0 

1 

i 

0 

0 

1 

1 

Result 

0 

0 

0 

l 

Cl 

0 

i 

1 


The ANDI (Logical AND with Immediate) instruction does the same thing, except that a constant value 
is specified In the instruction. This is useful for masking hit positions within a register or selectively 
clearing some bits while leaving others intact 

The logical function or is similar to and, except that its basic rule is that if A or B Is true, then the 
result is true. Only one of the operands, A or IL need he true for the result to be true. This is reflected In 
the truth table shown In Table 3-7. 
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Tub it -? - 7r Tttih Table for the Logical at Function 


A 

B 

Y 

0 

0 

0 

1 

0 

1 

a 

1 

1 

i 

1 

1 


The Logical or function in useful for selling particular hits within a register while leaving the other 
hits intact. There is also an 0 R 1 I Logical OR with Immediate) instruction available. 

A variation of the or function is called exclmim-or, XQR, or LOR. The logic behind, the exclusive- nr 
operator is similar to or, hut with a twist. The ruie states, "Y is true if A orE is true, but not both* See 
Table 3-fi for the truth table for the exclusive -or function. 

Tttb'it Exclushre-Qr Truth Table 


A B Y 

0 0 0 

i 0 1 

0 1 I 

1 1 (l 


The symmetry of the inputs and outputs makes Lheexclustve-or function a favorite of 
cryptographers. You get the same number of ones and zeros out as you put in, which helps to mask any 
sort of digital bias that could be used to crack the code. 


A Word About Missing Instructions 

To prevent redundancy within the limited instruction space, complementary instruction pairs have 
been omitted. An example is Lhc absence of an Add Immediate instruction. An identical result can be 
obtained by the creative use of the Subtract Immediate instruction, SUB I , and providing the two's 
complement of the desired constant value. This can easily be implemented in an assembly Language 
macro definition, allowing you to use tbe ADD1 macro Just as if it were a real instruction. Here is what the 
macro definition looks tike: 

.macro add! ; there is no add! (add immediate] instruction 

subi £0, -(gu) ; subtract the opposite 

.cndmacro 
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And here is how it's used in a simple example: 

ADD I kO t J 

The resulting instruction is actually SUBI RD > -(7). which accomplishes the same thing. Unless you 
tell it otherwise, the assembler isn't case-sensitim — that is, it makes no distinction between upper- and 
lowercase letters. 


Branch 

The conditional and unconditional branch instructions allow the program ro take various turns In Its 
execution. Tire EmmNdTrfoNdfftraHcfr simply jumps to another program location and begins executing 
there. Conditional branches test a particular condition and then perform the Jump only if the condition 
proves to be true. 

The most compact form of tire unconditional branch is tire R JMP (RelatLve lump) Instruction, it adds 
a relative offset from the present PC location to determine the destination address. If that relative offset 
is positive, the branch is forward. If the relative offset is negative, the branch goes backward. Tire range 
of the jump is limited to +2,047 and -2,049 program words. Recall that all AVR instructions are a multiple 
of 16 lilts (16 or :i2> in length. Tire R3MP instruction is a single word long. 

The IMP dump] Instruction is two words (32 hits) long. It allows a direct jump to any point within tire 
program memory. Because most program branches are to nearby destinations, it makes sense to use tire 
RJMP instruction where possible, to save program space. 

Conditional branches test the setting of the flags in the SRIiG. The flags are generally sci after any 
sort of mathematical computation; you can explicitly set them with the Compare Instructions (CP, CPI, 
CPC, and CiPSE). which subtract one value front another, set the flags accordingly, hui then discard the 
result. 

An example of a conditional branch Instruction is Elranch if Equal (BREQ). This branch takes place if 
the Z (zero) flag of the SR EG ls set. Tire 7. flag is set if a comparison of two equal values was recently 
performed, This code snippet Illustrates a conditional branch that will he taken: 

LDL Rifc, 32 

CPI Rib* 32 ; 2 flag will be set, because Rlb=}2 

BRED destination. 

destination: ; progra# execution resumes here 

The conditional branch instructions use a relative offset from the present PC value to calculate the 
destination address, similar to the R3MP instruction. The relative offset Jn an unconditional branch 
instruction, however, is limited to +63 and -64 program words from the present location. This turns out 
io he sufficient for most situations. If a longer jump is required, you can test tire opposite branch 
condition, with the destination being a short bop across an Interspersed RUMP or 1HP Instruction to the 
distant point. 

There are ten conditional branch variations for comparisons between signed values, ten variations 
for unsigned values, and eight simple branches that examine a single status bit. 

Two special versions of the branch instructions a re the CALL (Call to Subroutine) and RCALL (Relative 
Call Lo Subroutine) Instructions, These Instructions branch to another location but first push the current 
value of the PC onto the stack. The destination location is a subroutine, meaning that It's a modular 
piece of useful, reusable code that you can access from various points in the main program without 
having to rewrite Its function every place you need it. A subroutine ls expected to exit and return to It 
caller by popping the return value of the PC from the stack. A Return from Subroutine (SET) instruction Is 
provided to do exactly that. 
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The stack is a Last- In. first-out data structure that is supported In the hardware of the chip. A special 
register, the stack pointer, keeps track of what has been pushed onto and popped off of the stack. The 
stack itself is usually located in tire SRAM section. Special instructions, PUSH and IW, aliow arbitrary data 
to he stored in and retrieved from the stack, as well. 


Data Transfer 


Moving data around inside the chip is where the data-transfer instructions come into play. Data can be 
moved, loaded, stored, pushed, popped, and sent in or our. Most data transfers are it bits, but some 
allow 16 -bit transfers as well. 

The MOV (Move) instruction moves an 6-bit value from one register to another, because the value in 
the original register remains unchanged, the effect is actually that of a data copy, with both source and 
destination registers being now equal, and the original contents of the destination register lost. 

TheMQVW (Move Word) instruction performs a similar task, except that two registers are moved at 
once. The instruction Js limited to even-numbered registers. 

The simplest of the Load instructions is L01, or Load Immediate. This instruction loads an 6-bit 
constant value into a register. The LDI Instruction is limited to the upper 16 registers, RI6-R31: 

LOl Rl6, 0*99 l Rlfi wiLl now contain the value 0x99, or 144 decimal 


The other Load instruction variations copy data from the data -address space into a specific register. 
The LbS (Load Direct front SRAM) instruction specifies a 16-bli address within the data -address space, 
which includes the register file, the I/O space, as well lls the Internal (and possible external, if provided] 
SRAM array: 

LOS Rd, 0x130 j Copy contents of SRAM at location 0x180 to RO 


The bulk of the Load instruction variations use the index register X. V, or Z as the basis for the 
address to use and then copy the data into a register. Options for post-increment or pre-decrement of 
the Index register are available. Additionally, you can use the V andZ index registers with a constant 
displacement in the range of U to 66 bytes: 


LD 

_j 

LID 

Lj 


ROj X ; fEQ C- (X) 

Rl, Y+ ; ftl c- (Y), Y is then incremented (post -increment } 
R2 P -2 ; 2 = 2 - i (pre-decrement), then Rl (Z) 

R3, 2+4 ; S3 c- (2+4) index plus displacement (Y and 2 only) 


LPM (Load from Ptograin Memory) Is a special-purpose variation of the Load Instruction that copies 
a byte value from the program memory space, using the 7. index register, and stores it in a register. You 
cart also use this instruction on both the ATmegai28 and the ATmega2560 to read the fuse and lock biis. 

The Store instructions, S3 and STS. perform the complementary functions of storing data from the 
registers to the data memory in much the same way as the Load Instructions. The exception Js theSPM 
instruction (Store Program Memory), which takes a lifLie more preparation. The program memory is 
organized into pages (see Table 6-6), and each page must be entirely erased before iL can he 
reprogram nted. This self- program in ability is the basis ofthe Ardulno's bootloader function. 
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fubt* Program Memory Page Size 


Device 

Page Size 

Pages 

ATmega32B 

ft 4 words 

25ft 

ATmega2560 

12fl words 

1,024 


Data can be pushed onto and popped off of ilie stack using ihc PUSH and POP instructions, 
respectively. After a register is pushed onto the stack, the stack pointer is decremented by one. 
Conversely, the stack pointer is Incremented bv one before a POP instruction is executed, copying the 
value pointed to by the stack pointer to the destination register. 

The IN and Otii instructions are used to access the I/O register space, where most of the peripheral 
device configuration settings are located. 


Bit Manipulation 

The AVR architecture allows individual hits to be easily set. reset, and tested. This Is especially critical in 
embedded systems, where a single hit may represent a relay output or a sensor input. 

The BSE T and SOLS instructions that control the hits in the SR EG have already been discussed. The 
Sflfl (Set Bits in Register] instruction is really a special coding of the Logical OR with Immediate (0RI> 
instruction, where the operand ls bit-wise or’ed with the contents of any one of the upper Eft register, 
Rlb-Rj L . The tftfi (Clear Bits in Register) Instruction likewise ls a special coding of the Logical AND with 
Immediate iANUl) instruction, except that the constant value supplied U automatically complemented. 

You can set Individual bits In the lower end of the I/O space (I/O registers 0-31] using the SGI (Set 
Bit in I/O ltegisterj instruction, or clear them with the CBI (Clear Bit in I/O Register! instructions. These 
instructions don't affect the other bits within the accessed register. This is accomplished by using a read- 
mod Lfy- write cycle and causes these instructions to take two cycles to complete. This Is still faster and 
more code -compact than reading the I/O register Into the register file using an IN Instruction, making 
the necessary modification, and then writing the result back using an OUT Instruction. 


System Control 

Some random instructions that just don't seem to fit in anywhere else get stuck in the MCU Control 
heading. 

The SLEEP instruction puts the processor into a low-power state. Several levels of sleep are available, 
depending on how much power needs to be consumed (or not consumed, as the case may be! as well as 
the length of time needed to resume normal program execution given a proper stimulus. 

The WCift (Watchdog Reset) instruction explicitly resets the Watchdog Reset counter, which causes 
either a system reset or interrupt (depending on configuration) if Ignored for long enough. 

The WOP (No Operation] code simply takes up space and wastes time. Fortunately, it takes up exactly 
one program word of space and exactly one CPU cycle of time. This comes in handy when you require 
very accurate timing: for example, when one particular branch of a program takes exactly three cycles 
longer than another, yet they must both finish on the same exact cycle -count to maintain timing. These 
things happen. 
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Internal Peripherals 

What separates a mere m tcmpracemor ( such as ihe Z6Q, the 6502, the fi DBA, or even an Intel Pentium) 
from a microcontroller [s the inclusion of all those other bits that are required tor a complete computer 
circuit, including memory banks, clock circuits, and interface peripherals. 

The AVR family of microcontrollers offers a wide variety of internal peripheral Interfaces that make 
it easy to communicate with other devices. Let's look at some of the major peripherals you can use. 


General Purpose Input/ Output (I/O) 

The ATmega328 has three NO ports: Port B, Port C, and Port D. The ATnrega2560 has 1 1 I/O ports; Port 
A, Port B, PortC, Pori D, Port E, Port F, Port G, Port II (they skipped Port !}, Port I, Port K, and Pori !.. 

When configured as an output, the voltage on the pin can be set to either a logic-high level (V m .) or a 
logic-low level (CiND) by writing a I or a f] to the output port register (called the dam rggl&tefl hit, 
respectively. Additionally, each port phi can be individually addressed using hit -manipulation 
instructions. 

When configured as an input, each pin can be read as either a logic-high or logic-low level. Voltages 
above 0.7 *, V, , are considered a logic-high level and read as a 1 . Voltages below 0.3 x V, , are considered a 
logic-low level and are read as all. Voltages between these two levels are indeterminate. 


Mote You can read the approximate analog voltage values of inputs only by using the ADC peripheral, which is 
only available or either 6, fl, or 16 pins, depending on the processor. Digits! inpots (0 or 1) can be read on any 
general-purpose I/O pin. 


Input pins can also enable a built-in pull-up resistor, if needed. This allows the signal to remain in a 
known state when no external circuit is attached. 

Each I/O port Is programmatically controlled by setting bits within three I/O registers. The data 
direction register for each port contains a programmable bit corresponding to each pin. Programming 
the direction hit of a pin to a 1 makes it an output. Programming a ft makes that hit at) Input. After reset, 
all port pins are inputs by default. 

The data register for each port serves two functions. When an I/O port pin is configured as an 
output, the state of the corresponding pin in the data register determines the voltage level on the pin. 
When the pin Is configured as an input, writing a l to the corresponding data register bit enables the 
built-in pull-up resistor. 

The Input pins address reflects the current logic level on the associated pin. Don’t make the mistake 
of trying to read from the data (output] register (for example, PORTE}, because it only reports the last 
value, if any, written to that port. Reading from the input pins address (PINA, PINB, and so on) is the 
correct method of interrogating the outside world. 

You can also use the input pins address to toggle tire value of an output pin. Writing a I to a hit in 
the input pins address flips the corresponding hit in tire data register. This is much faster than reading 
the hit, performing a logical inversion, and rewriting the bit. 
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Extc rnal 1 nt er m p ts 

The AVft Core recognizes and can respond to two different types of external interrupts. Tire classic 
external Interrupts are the INTO and Ih'Ti pins of the ATmega328 and INTO-7 of the ATntega2560. 
Additionally, up to three banks of eight I/O pins can he configured as pin -change Interrupts, having the 
ahillty to notify the processor should a change occur. 

The I NT pins are a little more versatile than the pin -change Interrupts. Each IKT pin has Its own, 
separate interrupt vector, whereas each bank of eight phi-change interrupts shares a vector. Also, the 
1NT pins can be configured to trigger an Interrupt on a low-level Input, a rising-edge, a falling-edge, or 
either rlsing-or-falling-edges. The pin-change interrupts trigger on any change in level; but only a port- 
level flag is set, indicating which of the three pin -change Interrupt ports caused the interrupt, but not 
which specific pin. 

Each external interrupt source can be individually enabled or dl sallied. 

Externa] Interrupts are an excellent resource for embedded applications. Proper use of external 
interrupts can free the main application program from having to constantly poll a device or condition to 
see ifll needs attention. A classic example is a push-button input. If the main application is performing 
many tasks, it may not be looking at the push-button input line at exactly the moment the user presses 
the button. This can lead to the appearance of a non responsive system. Using a properly configured 
external Interrupt for the push-button allows the main application program to describe the conditions 
on which it should be interrupted and the appropriate actions to take place In that event. Now the main 
application program can busy itself with other tasks. Whenever the interrupt occurs, the Intended 
behavior is triggered automatically. 


Timer /Co u liters 

The ATmega328 has three timer/ counter peripherals available. Each one is a little different. The 
AT mega 2560, as you might expect, has even more. 

Let’s start with the ATmega328 and its three unique timer/ counters. They’re referred! to as 
Timer/Counter L), Tinier/Counter 1, and Timer/Counter 2. 


Timer/Coy nter 0 

At the bean of Timer/Counter 0 is an ft-bit counter. You can directly read from and write to this counter 
using the fl-bit TCNTO register. The behavior and operation of ihe counter are controlled by the bit 
settings in two configuration registers, TCCRGA and TCCROB. Many possible combinations allow a wide 
variety of uses for this versatile peripheral. 

As Its name suggests, this peripheral can be used as cither a timer or a counter. When clocked 
(triggered) by an external signal, It performs as a counter. When clocked from the system clock (or a 
signal derived from the system clock), it cast he used as a timer or frequency generator. 

The timer /counter can be set up to generate interrupts. This is a handy thing to have when you need 
to schedule something to happen on a regular basis. 

Another popular function is the generation of pulse- w Id th- modulated (PWM) signals. Two different 
PWM outputs can be controlled, although they share the same period and resolution. These PWM 
outputs, OCflAand OCtlB, are connected to PD 6 and PD5, respectively. On the Arduino IJno, these 
signals are called Dfi and D5. 
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Timer/Coynter 1 

Timer /Counter 1 shares many characteristics with the other timer/counters. Its principle distinction is 
that the internal counter is 16 hits long Instead of only fl. 

Two PWM channels arc also ava liable for this timer /conn ter, just Like Time tf Cols liter 0. These 
signals can he routed to output pins QC 1A ami OC lb, also known as PE5 ] and PB2, or DO and D 10 on the 
ArduLno lino. 

Timer/ Counter I also has an Input capture unit. This hardware allows very accurate timing 
moa su re me n e of incom i o g slgna Is. 

Timer/Coynter 2 

Another 6-bit counter Is found at the heart of Timer/ Counter 2. It's almost identical to Timer/Counter IK 
with two PWM channels (OC2A and OC2B, routed to pins P133 and PD3, a.k.a. Dll and DT r respectively), 
interrupts, the works. 

What makes Timer/ Counter 2 special is Its ability to dance to the heat of Its own drummer. It has an 
asynchronous mode of operation that allows It to be clocked from a source other than the system clock 
or external signals. Assuming the system is being clocked by the calibrated RC oscillator, Lhe otherwise 
unused crystal oscillator driver can he used to drive a low-frequency watch crystal. This configuration is 
ideal for low-power, real-time clock applications. Unfortunately,, there's no easy way to do this using ait 
Arduino without extensive hardware and software hacks. 


Timer/Counters of the ATmega2560 

The AT mega 2560 has all of the timer/counters of the ATmega320, aod then some. The two 6- bit counters 
(D and 2} are effectively Identical In operation. The ATmega2:560 adds three more of the 16-hit timers 
(named 3, 4, and 5), for a total of four. Each timer/ counter has 3 PWM channels instead of 2. bringing the 
total PWM count up to 14. That r s a lot of PWM channels! 

The pin-number license taken on the Arduino Mega 2560 allows all of the PWM outputs to be 
grouped together as digital pins DO-D 13. 


USART 

Mow here is a grand-sounding name fora peripheral: Universal Synchronous/Asynchronous 
Receiver /Transmitter. It’s synchronous and asynchronous! It’s a receiver andu transmitter! It's 
universal! 

It's a serial port. Get over yourself, already. 

The ATmega32S has one USART (still called U SARTO, even though Ifs the only one). The 
ATmega2560 has a total of four USARTs, which Is very nice. If they aren't needed, the TX and RX pins of 
the unused serial ports cat) be used as general-purpose I/O pins. 

just like the PWM pins of the Arduino Mega 2566, the additional IJSART pins are all grouped 
together. Immediately adjacent to tire existing RX and TX pins that are found on tire Arduino Uno. An 
extra pair of serial interface pins are also Included on this connector, hut they're a horse of a different 
color. 
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Two -Wire Serial Interface (TWl) t a.k.a. TC 

The ext rii serial Interface plus mentioned previously are the serial data 1'SDAj and serial clock (SCU pins 
of the I'C peripheral. TC is arcane shorthand for UC r or 1 liter- IC, which In turn stands for the I liter- 
integrated Cireuil hus, a communication specification developed by Philips {now NXP) to cor down on 
the number of wires ruining between chips Inside of television sets. 

The I'C name, logo, specification, and just about everything pertaining to It Is copyrighted, 
trademarked, restricted, and otherwise so nailed to the ground that Atmel calls it TWI for two- wire 
interface, or sometimes 2 -wire Interface, jo si to be different. Don't retl anybody, hut it works exactly the 
same. 

Although not marked as such, the ATmega328 also has a TWI peripheral, whose SDA and S CL pins 
are routed to the analog input pins A4 and AS on the Ardulno Lino. 

I'C bus Is a popular interface standard for many chip manufacturers. You can find memory chips, 
ADCs, accelerometers, real-time clocks, temperature sensors, and many more devices that 
communicate over there hus. 

The Arduino supports communication oil the I'C bus using the Wire library. 

The f'C spec allows up to 12? devices on a bus, although most systems have between 2 and 6 
devices. The TWI Interface is completely compatible with the DC spec. If you run into weird problems, 
perhaps you're not properly terminating the clock and daia lines. When all else fails, lower the clock 
speed and look at the signals with an oscilloscope to see what's going on. Also, make your driver 
software more forgiving of error conditions. All DC drivers must be interrupt driven, and that is its own 
kind of madness. 


Analog Inputs 

Both tlie AT mega 3233 and ATitiega25S0 have an ADC peripheral. The main difference between the two 
chips is the number of multiplexed Inputs provided to the converter. TheATmega32ft provides 6 Inputs 
(ft in the S M D versions), and the ATmega2S60 offers a whopping lt> Inputs. 

On both the Arduino Unn and Ardulno Mega 2560, the analog inputs are collected together on one 
or two connectors. The Arduino Uoo has Inputs numbered AO- AS, and the Arduino Mega 2560 has 
numbered Inputs A0-A1 5. 

These analog Inputs can measure voltages hi the range of 0-5 V. The actual range is determined 
by the settings in the peripheral configuration registers and rbe voltage, if any, applied to the A REF 
input pin. 

The ADC, when properly configured and triggered , can convert the incoming analog voltage into a 
number in the range of tl-l ,023. Zero represents a voltage at or near ground, and a reading of i ,023 
indicates a voltage at or nearAREF. This corresponds to ten bits of resolution. 

The reading of the analog inputs is directly supported in the Ardulno programming language using 
the analogReadO function. This function takes a single parameter |thc number of the analog pin in be 
read) and returns a value between 0 and 1,023. 


Summary 

You've only scratched the surface of the AVB . There's a world of details Inside that little silicon chip. 

If all IhLs Information has threatened to overwhelm you, take heart. You don't need to memorize 
every fact and specification concerning these devices. It's enough at this point to be aware of them In a 
general way. More Important, you should have a good idea about where to start looking when you need 
more detailed Information about a particular aspect of the system. 
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Download a local copy of tlie datasheet for your favorite AVRs, and take some time to browse 
through them, even if only to remember where the Information can he located so you can took it up 
quickly when you need it. 

Even If you don't plan to write your own assembly-language programs for the Ardutno, a good 
baseline knowledge of the lowest -level building blocks will serve you well r especially when you start 
wanting to optimize your sketches for either speed or sLze. Chapter 6 goes into tremendous detail about 
how you can do that, and It relies on your understanding of what Is involved,, if not the exact 
im pie me n t atio n de ta Lis. 
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Supporting Hardware 



In Chapter 3, you explored the deep -down -inside parts at the heart of the Ardulno, the Atmel AVR. With 
so much internal complexity, it's hard to believe that yon would need anything else; but you do. 

First, the chip needs power to perform all that magic. Second, If you don't connect the chip to 
something, no one will ever he able ro tell that anything Is happening. 

Let’s take a detailed took at each of the major areas in the basic Ardtiino circuit. These areas include 
the following: 

* Power supply 

* Serial interface 

* Processor a n d a sso c ia ted co m po n ent s 

* Esp ans lo n con n ect o rs 

The chapter also looks at the mechanical form factor in some detail and Includes a special section 
on the Universal Serial Bus (USB) interface on modern Ardulnos. 


Schematic Diagrams 

When a circuli has more than one or two components, It begins to be difficult to clearly describe It using 
words alone. A simplified, stylized diagramming technique has been developed over the years to help 
facilitate this necessary form of communication. An electronic schematic diagram represents Individual 
components as symbols, usually connected with solid Lines to indicate the wiring connecting the 
components. See Figure 4-1. 
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Pig are 4 ■■ i . Art example schematic diagram 

Other technical occupations also have their own version of schematics. Any sort of stylized 
representation that focuses only on the essential components and their Interrelationships can he 
classified as a schematic. Electrical or electronic schematics are ] u stone exam pie 

If you're already familiar with modern electronic schematics, please feel free to skip Lo the next 
section. If not* here are the very basics you need to identify Individual components and start to see the 
relationships expressed with ail those squiggly lines. 

Figure 4-1 represents a classic LED blinker circuit* the astabie multivibrator. It’s called asiable 
because it doesn’t stay in anyone state for very Long; It blinks back and forth with only one LED on at 
a time. 

One side or the other is on. conducting current through the LED, the current-limiting resistor, and 
the transistor. Meanwhile, the capacitor is charging; when it reaches a certain threshold* it causes the 
other side of the circuit to turn on, lighting its LED and extinguishing the other side. The cycle repeats as 
long as power is applied Lo the circuit. 


Component Types 

Five types of electrical components arc used In the blinker circuit; LEDs* resistors* capacitors, 
transistors, and batteries. Technically speaking, there is only one battery In tills circuit, and It happens to 
be composed of three individual cells, hut most people refer to the individual cells as batteries. 

Each of the components lias a distinctive appearance In the drawing. The thin lines connecting the 
components are wires or electrical connections on a printed circuit board (PCB)* Each component 
should also be clearly labeled with enough Information to properly identify it. 

The schematic should contain enough Information to build, examine* or repair the circuit. 
Additional notes are often found on schematics to help explain non -obvious aspects of the circuit or 
provide any necessary advice or warnings that may apply. 


Reference Designators 

The most obvious components, due to the purpose and design of the circuit, are the two LEDs, labeled 
Di and D2. The names Dl and D2 are called reference designators. Reference designators are usually a 
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combination of a short abbreviation [D for diode: LEDs are light emitting diodes) and a unique number 
Because [here are only two LEDs in this circuit, they're simply named Dl and D2_ They could just as well 
have been named Red LED and Green LED. As long as each individual component is uniquely 
identifiable, you can name them whatever you want. 

Even If multiple, identical components are used in a circuit, it helps to carefully number them when 
com pill n g a bill of materia ft ( BO M ) . Tb is is a n tm po rt a n t doeum en tin the m an u fac t u r 1 ng process , an d 
it's also very helpful when you’re publishing assembly Instructions to share with others. 

In more complex schematics with many sections, each section may have its own range of numbers 
for Its components: for example, the power-supply section may have seven LEDs numbered DJ.01-D107, 
and the CPU section may have two LEDs numbered D2DI and D202. Nothing says the numbers must he 
sequential. 

Some circuit designers prefer to number [he components according [o tire logical layout as 
expressed In the schematic. Other designers prefer to arrange the numbering of the components to more 
accurately represent their physical location in the final, assembled circuit. 

The choice of abbreviations for component types varies considerably from one schematic lor 
continent) to the next. This book uses the abbreviations shown In Table 4- 1. 

Table 4-1. Schematic Diagram Component Abbreviation Prefixes 


Component Type 

Abbreviation 

Unit of Measure 

Symbol 

Resistor 

R 

ohms 

a 

Capacitor 

c 

farads 

F 

Diode 

D 



LED 

D, LED 



Transistor 

Q 



Integrated circuit 

u 



Crystal 

X 



Connector 

J 




Integrated circuits are also sometimes labeled Xor 1C. The U convention, Interestingly enough, 
comes from the bad English phrase utt-repalrahle subassembly. Connectors are sometimes also 
abbreviated X, as in the Ardutno documentation. 


Component Values 

Each nontrivial component should also have a clearly stated value. The needs of the ctreuii determ ine 
the level of detail given. Noncritical components can get by with just a simple numeric value, usually 
representing the component's characteristic function. For example, nesftrors are placed in a circuit to 
resist the flow of electrical current, and the amount of that resistance Is measured in ohms, whose symbol 
is the capital Greek letter omega, il. 
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Component values can be abbreviated by using multiplier prefixes. Resistors, for example, are 
available in values From less than one ohm to many millions of ohms. Instead of writing 1,000 il , you 
could write Ik il , prefixing the unit of measure (ii) with the uppercase letter A r [from the Greek prefix 
kilo, meaning one thousand). Other common multipliers a re given In Table 4-2. 

fa bit 4-2, Comm on Component Value Prefixes 


Symbol Value 

Exponent 

Prefix 

S> 

0. 00000000000 1 

10' 12 

pico 

n 

o.ooooooooi 

10' 

nano 

H 

0.000001 

10" 

m icro 

m 

o.oo i 

10 

mini 

K 

1,000 

10' 

kiln 

M 

1,000,000 

10‘ 

mega 

G 

1,000,000,000 

10’ 

giga 


Both larger and smaller multipliers Stave been defined, but they're rarely used in specifying 
electro n ic com ponen i va lu es. 


Component Value Tolerances 

Very often, component values only have to be close enough to a particular value to he effective. For 
example, when you're selecting a value for a current-limiting resistor to be used in conjunction ivith an 
LCD, Ii won't make any visible difference to the naked eye If a 1,000 fi ora 1 ,007 il resistor is used. 
Common resistors, such as those found on the Arduino PCB, often have value tolerances of ± I % for 
resistors, meaning that the actual value of the resistor could vary as much as + i% or -1% from tlte 
labeled value and still be close enough. Capacitor values can be much looser with tlte tolerances, 
sometimes rated at +S0%, -20%. 

Due to the relatively low precision of most component values, only a small number of significant 
digits are required in their specification. This is generally limited to two or at most three digits, In most 
cases. An example is a resistor rated at 2.200 ohms. It can be written as 2.2k il or even as just 2..2K. 

You also see a further compacting of component values by replacing the decimal point with the 
multiplier and omitting the unit of measure (when it's understood}: for example, 2,200 oh ms can be 
written as 2K2. 

Other Component Parameters 

When appropriate, a component on a schematic may also be labeled with oilier Important ratings, such 
as maximum working voltage (In volts, or V) or power-handling capability (in watts, or W). These 
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indicators tend to be the exception and not the rule in electronic schematics, and they may only he 
round In a detailed hi LI of materials. 

In more complex electronic components^such as semiconductors, titer e Is no primary component 
value other than a manufacturer's part number. When this Is the ease, the schematic lists the part 
number as Its value. 


The Connections 


Solid lines are generally used to represent electrical connections between components. Each component 
has one or more electrical terminals orpins that allow it to be electrically connected to the other 
components. These components leads are often drawn as short lines emanating from ihe body of the 
component symbol. Even unused component leads are generally shown In schematics, even 11 Just to 
show that they aren't supposed to be connected to anything in particular. These pins are sometimes 
labeled N/C (no connection] or not labeled at all. One convention is to- place a small x at the end of 
unconnected pins, hut this isn't universal. 

There are two special conventionsconcerningelectricalconneetlon notation that may not he 
obvious to the casual observer. The Erst is the use of implicit or explicit connections among signals 
(often referred to as wer.s'1 that have more than two endpoints. One style is to show explicitly connected 
nets with an obvious dot at their Intersection, whereas unconnected signals can cross without Indicating 
that they're electrically connected at all. The opposite convention is to show a small arch in Lhe 
horizontally drawn line to indicate that It hops over the other signal without making contact. The first 
convention is more prevalent these days and Is the one used In this book. 

The other important notationa! convention is the use of buses where multiple electrical 
components are connected to the same signal. There are several ways of Indicating these connections 
without explicitly drawing a tine for every one of them. 

A very common example is the use of the ground symbol Ground is an electrical concept from 
which all other voltages are referenced within a circuit. It’s sometimes, although Infrequently, actually 
attached to the ground (that is. the Earth- ground is sometimes replaced with the term earth). The 
ground symbol appears three times in the schematic io Figure 4-1: a short, vertical line with three 
horizontal Lines of diminishing length. Can you find them? 

At the top of the schematic In Figure 4- i you can also sec five rnund symbols labeled V i , which 
literally means the voltage of the common collector. All five of these points in the circuit are considered 
to he electrically connected to each other, even though they aren't explicitly shown as connected with 
solid lines. 


Getting Power to the Board 

The very first Aid uino I/O Boards had a very simple power- supply circuit. Despite its simplicity, li was 
quite versatile, allowing you to provide either regulated or unregulated power, as well as routing power 
to the expansion connectors to power any shields that might he attached. The power-supply section of 
the original ArdnLno schematic is shown in Figure 4-2. 
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-tStf 



Figure 4-2. Power-supply section of i he Original Arduino serial schematic 


The Barrel Connector 

The unlabeled block on [he left side of the drawing Ls the barrel connector for unregulated direct current 
(DCj power input. The part outline vaguely resemble a the side view of the barrel connector itself, 
although the electrical connections aren't physically arranged in the same order as the part. The symbols 
used In both the Ardulno Serial schematic and the present Arduino Uno schematic are the same, but 
they don't correctly reflect the manufacturer's pin-numbering scheme, the physical connector Itself, or 
industry standard conventions. 

Two of the electrical connections to the barrel connector (labeled pins 1 and :'l in this schematic) are 
connected to ground. Mote that the power connector has no preference as to polarity- It's the circuit 
designer's responsibility to establish this important arrangement and adequately document it. 

The barrel connector has a center pin in the middle of a circular opening. The diameter of the pin is 
nominally 2.1mm, and the inside diameter of the opening is 5.5mm. At the bottom of tire housing is a 
spring-loaded terminal that presses against the outside of the power ptug when inserted. These two 
terminals make electrical and physical contact with the power plug. The third terminal coming from the 
barrel connector housing is attached to a mechanical switch. This switch is dosed [shorted to the spring- 
loaded side terminal) when no plug is inserted and often when a plug is present. This could he used to 
switch from internal to external power when a plug Is Inserted or removed, hut it isn't used for this 
purpose on the Arduino. 

This is a very common connector for low-voltage DC power supplies. It’s produced by several 
different manufacturers. Depending on the exact manufacturer and part number, the connector Ls rated 
at 16V-24V and from 2.5A-4.0A of current. You must take Lhis Into account when budgeting power to 
external circuitry. 

Oil, Inc. manufactures a connector like ibis, and you tan see the company's detailed datasheet 
with all the part dimensions and electrical specifications at http://pi'oducts,cui.com/C.Ul_H i :i- 
0 O 2 fli_Datasheet. pdf?f ileltM45ft. 

The barrel connector remains the same on every standard form -factor Arduino produced so far. 


Input Power Conditioning 

The second pin on the barrel connector is ihe positive voltage connection and is connected directly to 
the anode as positive lead of Dl, a diode here employed as a rectifier. A rectifier allows current id pass in 
one direction hut blocks the flow of current In the opposite direction. DFsJob is to prevent current from 
flowing at all, should the input voltage be of the wrong polarity (that Ls, plugged in backward). This is a 
idee product safety feature that costs little and potentially saves much. 
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Note the am™ -Like appearance of the diode schematic symbol. This helps orient the reader as to 
the allowed or intended direction of current flow. The bar of the cathode terminal is often printed on the 
physical part, helping to orient it during assembly. Unfortunately, it only indicates the Tow of 
conventional current, which turns out to he exactly the reverse of the reality of electron flow. Electrons 
(the charge carriers in metallic solids, such as copper wire), having a negative charge, actually flow from 
negative to positive potentials. 

The Input rectifier, Dl, is specified In the original schematic as a 1N4G04, which is a generic 
manufacturer's part number Fora l.GA (maximum) rectifier diode. The 1N40O4 Is only one In a whole 
family oF similar diodes, numbered from IN4G01 to IN40O7. The main difference between the various 
part numbers is the maximum DC blocking voltage [V,), ranging from 50V for the 1N40Q1 to 1,000V for 
the IN 4007. The lN4tlU4 is rated at 400V. 

A rating of 400V is a hit of overkill for this application, but many of these design decisions are based 
on parts' availability and cost, rather than the best fit from a specification standpoint. It’s common to 
see very wide variations In both pricing and availability, both critical factors to manufacturing. 
Considering that the input voltage was previously limited by the power connector, any of the diodes 
from this series would serve adequately. 

The modern Arduino lino Iras a surface-mount version of the IN40G7 (dubbed the M7) in this 
position. 

The limiting factor to consider, as far as the reverse- polarity -protect ion diode Dl is concerned, is 
the 1.0 A maximum current rating. The Arduino circuitry draws merely a small Fraction of one ampere 
(usually shortened to amp or A) of current. Additional circuitry must not push this over the 1.0A limit, or 
Dl will overheat and eventually fail, usually with burny and sometimes smoky and even Flamy results. 
The smeil Isn't nice, either. 

If power is being supplied from another source, such as the USB adapter or another connector, the 
limitations of tire barrel connector and the reverse-polarity-protection diode Dl can be overlooked. 

Note that D l's rectification characteristic prevents power from being supplied to external circuitry' via 
the barrel connector. 

DTs cathode, or negative terminal, is connected to several other points within the circuit. Note the 
use of the explicit connecting dot to show that the several lines are, indeed, electrically connected. 

From the connecting dot upward, then over to the right, Isa connection to the voltage bus VIN, or 
input voltage bus. On the original Arduino Serial, this went to only one other location: a pin on the 
power-expansion connector, also labeled VIN. This additional connection allows the unregulated input, 
voltage to he supplied to expansion shields. Alternatively, It can also be the source of unregulated power 
to the Arduino board, bypassing the barrel connector and reverse-polarity-protection diode Dl. 

On more modern Arduino boards, tire VIN signal is also used to help decide what power source is 
selected to power the board. This involves a little more circuitry and is described in more detail in the 
"Power Circuit Evolution" section, later In Ibis chapter. 

After e lit.- diode, the power signal is attached to two different kinds oF capacitors, CSandCJk Notice 
that although the two capacitor symbols are similar ftwo separated plates, which succinctly describes 
how a capacitor is built], there is a subtle but important distinction. Cfi is polarized, and the positive 
connection is labeled in the schematic with a small plus sign (+). Oddly enough, the negative lead of a 
physical capacitor is the one that is usually marked. C5, on the other hand, is nonpolarized and can he 
installed in the circuit in either possible configuration. Installing C6 backward in tire circuit can lead to 
component failure, including possible expansion and rupture oF the containing sleeve or can. 

The two capacitors Cft and C5 form a filter, serving as small reservoirs of electrical charge and 
filtering out much of the electrical noise from the power- supply input. 

Cfi is rated at 100u, which is understood to mean lOO.uF (for micro -farads; the lowercase Greek letter 
mu or p being sometimes difficult to reproduce In ail computer-aided design, or CAD, software 
packages). 
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C5 Is rated at lOQn, which is understood [ft mean lQOnF (for nano -farads), even though it's more 
likely [ft see this expressed as 0.1 gF in [he United Scales. 

Net documented in this schematic are the maximum working voltages of the two capacitors. This is 
a critical component specification for capacitors. Applying voltages in excess of a capacitor's rated 
working voltage will result in the deterioration and eventual failure (perhaps catastrophic) of the 
capacitor's dielectric, which is the material used to separate lire two conducting plates that form the 
capacitor. Lower working voltages allow smaller capacitors to he built, so a prudent design engineer 
specifies a working voltage that Is high enough to perform safely in a circuit hui low enough, not to take 
up excessive space or Increase costs. Common working voltages for electrolytic capacitors range from 4V 
to 50V. The capacitors serving this function on tire Arduino IJno, PCI, and PC2 arc rated 47pF at 25V. 


Voltage Regulator 

Now it's time to regtiiate the incoming voltage for use with the rest of the Arduino circuitry. 1C2 is a 
three-pin, fixed positive voltage regulator of some sort. No pari number is given in the original 
schematic. Remember, the very first Arduino hoards were Intended to be spread by word of mouth as 
much as by postal carriers. It was up to [he individual building the circuit board to make the final parts 
selection based on their needs, availability, and best Judgment. 

The LM7&05 fixed positive voltage regulator was often used In [bis position. It’s quite common in 
bobby electronics and widely available. Although the part has been discontinued by National 
Semiconductors, it's still produced by many other vendors. National Semiconductor also provides a 
detailed data sheet for [be device: www.national.corn/ds2LM/LMr5l2C.pdf. 

Ibis part was available in several fixed voltage outputs, including 5V, 12 V, and 15V. The SV version, 
the LM7BG5, required a minimum of 7 Vat [he input to guarantee stable 5V output. The current rating 
was siated as in excess of iA, assuming that adequate provisions were made to keep the device cool (that 
is, heatsinking). 

The original Arduino documentation recommended ait input voltage in the range of 7V-I2V. This 
type of voltage regulator is called a linear regulatory because the supply voltage Is carried straight 
through [be device. Excess voltage is wasted as heat. This becomes a problem as either the input voltage 
or the output current consumption rises. 

For the T0-22O package (the LM78G5 was also available in a larger, TO-5 package], the thermal 
resi&ta nee (Junction to ambient) was listed asSCPC/W. With a minimum 7V input and only 0.5 A of 
current being drawn, this amounted [o 1W (TV - SV - 2V, 2 V n 0.5 A - 1VVJ of power dissipation, raising 
the temperature of tire device 5(l*C greater than its surroundings. That’s hoti Increase either the input 
voltage or the current draw by very much ai ail. and the device will enter a self-imposed thermal 
shutdown until the temperature drops back to a reasonable level. 

The output of [be voltage regulator is supposed to be 5V with a tolerance of 5'&, or anything from 
4.75V [o 5.25V. The 5V output is connected to another filter capacitor, C7. C7 Is identical to CO, a 
polarized electrolytic capacitor rated at lOQpF. and does a similar job, filtering out transients and 
glitches from the voltage supply. On the original Arduino Serial, the +5V supply hus was routed to the 
power-expansion connector (to a pin labeled +5V), making regulated power available to additional 
circuitry. The -+5V bus also directly powered the ATmegafl microcontroller chip and the RS-232 to TTL 
level s3il her circuit, described laier. 

Also shown in the schematic is a connection from the regulated 5V supply line to LED l. which 
served as a power-on Indicator. A 2200 current- limiting resistor, R2, was interposed to control Lhe 
amount of currcm flowing through the LED. This LED is on the entire time the Arduino has power. 

If a regulated source of + 5V power is available, the Arduino can be powered directly via the +5V pin 
of the power-expansion connector. 
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Power Circuit Evolution 

The modern Ardulno Uno and Arduino .Mega 256U have basically the same power Input and 
conditioning circuitry as their forebears. The Ardulno Uno moves the lOOnF capacitor from the input of 
the voltage regulator to the output. The Arduino Mega 2560 doesn't. 

There have been a couple of interesting developments along the way. Looking at the Uno or Mega 
2S60 schematics, there appear to he two 5V voltage regulators in the circuit. This Is a technique for 
providing multiple cam ftottetu fetoiitrinis on the PCB, and only one of the two voltage regulators Is 
eventually populated on the PCR. To prevent confusion, you can name the duplicate parts with the same 
reference designator hut with an alternate suffix: for example, if both a through-hole and a surface- 
mount version of a resistor are drawn on the schematic, you can label one hi A and the other Rlli. If one 
particular package variation Isn't available at manufacturing time, then the equivalent device in a 
different package cat] be substituted without requiring the PCR to be modified, or reworked. This same 
technique was used for the surface-mount version of the ATmega328 processors on the Ardulno Uno 
SMD, as illustrated in Chapter 1. 

When the USB Interface was introduced, replacing the older RS-232 Interface, more changes to the 
power- supply circuit occurred. The USB specification allows the Interface 10 provide a lint Lied amount of 
regulated power to devices, along with the communication facilities. A regulated 5V supply is taken 
directly from the USB connector and can be used to power the circuit. The first USB models required 
you to correctly Install jumpers to complete the wiring of the power-supply section. Later models used 
an analog comparator and low-impedance metal-oxide-semiconductor field-effect transistor [MOSF.ET) 
switch to intelligently switch to the highest available voltage. Additionally, a 500 m A resettable fuse was 
included in the USB power tap to prevent Bad Things from happening to the host PC should so me tiling 
untoward occur on the Arduino or any attached circuitry. Tills resettable fuse normally has a very low 
resistance and passes up to 500mA (0.5 A] of current. If the current draw exceeds this value, the fuse 
begins to beat up. increasing its internal resistance and thereby lowering the amount of current allowed 
to pass through the circuit. When the current draw decreases, the fuse cools off and Its internal 
resistance drops. This process, it should be noted, can't be repeated indefinitely, because the thermal 
stress to the fuse will eventually cause it to fall. 

The first several Arduino USB versions employed an FTDl USB interface chip, which Included an 
on-board 5 V to 3.3V regulator. This allowed 3.3 V at up to 50mA of current to be made available to 
additional circuitry, should the need arise. Voltages lower than 5Vare becoming more common as the 
demand for lower power consumption Increases in electronic devices. 

The Ardulno Uno and Ardulno Mega 2 560 have dropped [be LTD! USB Interface chip In favor of an 
additional AVH microcontroller, dedicated to USB communication tasks. They have also added a stand- 
alone 3.3V regulator chip on-board to replace that functionality Lost with the change in USB chips. The 
National Semiconductor L.P29f)5 low-dropout regulator cast supply up to 1 50 mA of current at 3.3 V, 
tripling the amount of current previously available. 

Looking at Figure 4-3, you can see lhat not much has changed in the front estd of the Ardulno power 
supply over the years. Figure 4-3 is taken from the schematic of the Arduino Mega 2560. The Arduino 
Uno moves C2 from the iaiput of IC2 to the output: otherwise it's Identical to Figure 4-3. 

Not shown in Figure 4-3 is the power-oat LCD Indicator, which now 1 has a IK resistor (RN3C) to limit 
the current. Instead of a discrete (Individual} resistor, [he modern Arduinos use a res /s tor network, ll 
small package that contains several identical resistors. This makes them easier to assemble via 
automation, placing a single component Instead of a bunch of individual ones. 
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Figure 4-3. Power-supply section of the Ardnitio Mego 2560 

The additional power -supply circuitry „ Including the Intelligent voltage -selection circuit and 3.3V 
regulator, Is shown In Figure 4-4. Not shown Is the resettable fuse, which Is Inline with the USBVCC 
voltage bus, coming from [he USB connector. 
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Serial Interface 

The serial interface of the Arduino survives functionally intact from the very earliest prototypes until 
today. A good case can he made for the argument that the serial bootloader arrangement de/lwesthe 
Arduino development methodology, separating Ll from bare- metal embedded development. 

There are, in fact, several distinct serial interfaces available on the modern Arduino, thanks to the 
wide variety of peripherals offered hy the Atmei AVR processor. The most famous serial port in the 
Arduino world is the Universal Synchronous/ Asynchronous Receiver/ Transmit ter fUSART] peripheral, 
which sends or receives data over a sit]gle wire (one wire for each data direction, plus a 

ground reference connection! at a predetermined rate. Other useful serial peripherals include the two- 
wire interface la.k.a. TW1 or I J C> and the serial peripheral interface (SPI], both of which use a separate 
clock and data line to communicate with other devices. Ethernet Is another serial peripheral that can 
easily he added to the basic Arduino circuit using a special shield. 

Unfortunately, there is no standard PC serial port that can work directly and reliably with the Atmei 
AVR chips used with most Ardulnos. A buffer nr level-shifter circuit is needed, at minimum, to allow Lhe 
Q-5V signals of the AVR to talk properly to the most common PC serial port standard, RS-2;'i2. The 
modern alternative, the USB standard, is generally thought to he too complex, when fulty realized, to be 
accommodated by a simple microcontroller like the AVR. Effective solutions to hotb Interfacing 
challenges have emerged, and you look at them in a little detail here. 


RS-232 Interface 

The oldest Arduino prototypes, and some modern reproductions, provided a level- shifter circuit to 
convert the RS-232 voltage levels to the appropriate 0-oV levels used by the Arduino. This circuit was 
built of discrete components and is shown In Figure 4-5. 
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Figure 4-5. The RS-232 to TTL level-shifter circuit from the original Arduitto serial 

This circuit hears a striking resemblance to [he RS-232 Interface used in both the original AVR 3SP 
device programmer as well as the example programmer described in Atm el's AVR application note 
AVR9 1 0 r " In - Syst em Pro gra mm J ng. " 

A more robust interface circuit can be built using a dedicated RS-232 adapter chip and some 
capacitors. The Maxim 1C MAX232 chip contains a built-in charge-pump circuit to generate tire required 
RS-232 voltage levels and ail [he level-translation circuitry needed, while providing much higher 
Isolation levels and protection. This circuit was never used by the Arduino Team hut was picked up 
by several versions of the Freeduino project Including the MaxSerial from Fundamental Logic . See 
Figure 4-6. 
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Figure 4-6. The Fundi mien tal Logic Freedttino MaxSerial serial port. Front the Fundamental Logic 
Freeduino MaxSerial. Designed by Circuit toy and Spiffed. Based on the Arduino Dieclm ilia reference 
design: www. arduino. c c/en/Haln/Ardui nottoardDie einii 1 a. Released under a Creative Commons Share- 
alike attrib u i to n license: see nww . crca ti tfecaiwKifls . org/licens es/by - s a/2 . 5/. 

This circuit also Introduces the use of the RS-232 handshaking signal Data Terminal Ready ( DTR ) to 
he used to remotely reset the microcontroller (the au to-reset feature), which in turns invokes the 
hoot loader firmware. Previous hardware required you to manually reset the Arduino board before 
starting the sketch -upload process. 

Although the Arduino documentation indicates that the RXand TX lines (DO and Dl. respectively) 
can he used as normal 1)0 lines it' serial communication Isn't needed In your application, this Isn't 
entirely true. The TX line (D 1 ;• can he used as either an Input or an output but will continue to wiggle the 
TX circuitry of the serial port, which may or may not cause problems on the other end. 

The RX signal (DO), however, remains connected to the receiver circuitry and must he physically 
disconnected before it can be used as either an input or an output. There Is no convenient way to do this 
no most Arduino boards. The options are to either remove components or cut traces, either one of which 
will render the Arduino unprogram mable via the bootloader. 

Later Arduino boards replace the R5-232. with a USB port, which Is described in more detail in the 
section “Universal Serial Bus (USB): Signals Plus Power,'' Eater In this chapter. 


The Processor 


In Chapter 3, a great deal of information was presented concerning the Internal workings of the Atmel 
AVR chip. Here you look at the AVR as just another (if complete) electronic component. 


Power Consumption 

Both the ATmega32S and theATmegaSStib share an absolute maximum supply voltage of fi.OV. 

Operation at or even near the absolute maximum value “may affect device reliability," according to the 
Atmel datasheet. The normal voltage range for both parts Is l.fiV to 5.5V. Note that lower voltages reduce 
the maximum possible clockspeed. 
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The power requirements of the AVR depend mostly on the operating Frequency oF the CPU. The 
higher the frequency, the higher the current consumption. At 16MHz, the ATmega328 draws just under 
10mA (0.0 IGA) of current at 5,0V, or 1/20W in active mode. Current consumption in Mid mode is Less 
than 2.5mA (0.QQ25A). This drops to less titan IpA (Q.OOOQOIA) in power- rionwt mode. 

The larger chip on the Arduino Mega 2560 r the Atmcl AVR ATmega2560 r draws only twice the active 
current of the smaller AT'mega328 at 5V and IS MHz: 20mA (0.020 A). The idle current consumption is 
under 6mA (0.QG6A), whereas the power-down mode draws less than IgA (0.000001 A) at or near room 
temperature. This can increase to as much as LkiAat elevated temperatures f85*C). 

The dock speed, as well as other power- consumption options, such as Lite Watchdog Timer and 
Brownout Detector, are configured using the device's configuration fuses. These fuses can't be changed 
under software control and require a dedicated device programmer tn alter. 

The power-saving modes {idle and power-down) are entered when the chip is put to sleep and halts 
execution. The difference between the two modes is that in idle mode, the peripherals continue to 
operate normally and can bring the processor out of the sleep state by generating interrupts. The power- 
down mode achieves its iow-eurrem usage by also shutting down the peripherals. 


I/O Drive Capability 

Each ] j'O pin on either chip can source or sink up to 40mA (-0.U4GA) of current. This Is sufficient to 
Interface with most external electronics, as well as light up a few LEDs. It isn't nearly enough to drive 
even small electric motors. fans,. or solenoids. 5-V relays with coil resistance of greater than 12511 can 
he directly driven, but a flyback diode should be placed across the coil to prevent a collapsing magnetic 
Reid (once the relay coil has been de-energized) from creating a hazardous voltage with respect to 
the chip. 


Note Dear in mind that the total current of alt I/O lines is 200mA (0.2A), so it isn't possible to drive 40mA from 
all 1/0 lines at the same time. 


The -RESET Signal 

The reset signal to the AVR is attached to several components In a typical Arduino. The DTR signal From 
the serial port is capaeltively coupled to the reset line via a l OQnF (0. 1 pE) capacitor. This capacitor allows 
the change in signal level to trigger a reset on the chip, but it prevents the . serial port from holding the 
chip in a reset state indefinitely. A I UK ft puilup resistor Ls also connected between the reset Kne and +5V, 
to prevent random electrical noise from falsely i ripping the reset circuit. A momentary-contact push 
button can also short the reset line to ground, thereby causing a device reset. 

The reset signal Is also connected to pins on both the In-circuit serial programming (1CSP) 
connector and the power-expansion connector. 


The Time Base 

Either a quartz crystal ora ceramic resonator Is attached to the AVR to provide a stable and accurate 
time base. You can use additional discrete components depending on the choice of component. Quartz 
crystals generally have very small value-loading capacitors attached between each of their leads and 
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ground. These capacitors help provide enough Load to start the oscillator circuit at power-up. The values 
are typically only a few pleo- farads [22pF Ls a common value:-, and tire capacitance resulting front the 
routing of tite signals on the PCB is often sufficient to ensure stable operation. 

Ceramic resonators often employ a high- Impedance resistor (typically 1 Mil or larger] across their 
leads to help stabilize their operation and reduce unwanted harmonics. 


Decoupling Capacitors 

The Arduino Uno Iras a single lOOnF (0.1 pF] decoupling capacitor, Cti, physically Located near the 
processor to help filler out any noise on the power bus generated by the processor itself, it also helps 
provide a tiny reservoir of power for the chip* whose power consumption comes In sharp spikes during 
different phases of tite clock cycle. 

The Arduino Mega 256'U has three similar decoupling capacitors, CA, Co, and Cti, located In close 
proximity to the ATmega256G chip, performing the same duty. 

Both the Arduino Uno and tite Arduino Mega 2560 have a IttChiF (HLpF) capacitor between the 
analog reference fAREF) pin and ground to stabilize the analog reference voltage used by the analog-to- 
ri ighal converter (ADC) peripheral. 


Blinky Lights 

Both the Arduino Uno and Arduino Mega 25fitl have a dedicated LED attached to DILI (PBS on I he 
Arduino Uno and PB7 on the Arduino Mega 2560) via a Hill resistor to ground. This Is sometimes known 
as the programmable LED, because Its function is based entirely on software. In contrast, the green 
power-on LED Indicator Is always on whenever power is applied. The T'Xand RX LEDs are connected to 
the USB interface chip and indicate activity on the serial port. 

Room for Expansion 

By itself, the Arduino I/O Board doesn't do much at all. It's possible to have a sent L- Intelligent 
conversation with it over the serial port, Lf you're willing to stretch the definitions of the words 
cau venation* in ielligenr t and possible. For more useful and practical applications that can actually be 
accomplished today, let's lake a look at the provisions that have been made to extend the reach of Lhe 
humble Arduino. 

Even the earliest Arduino prototypes had some sort of expansion headers Installed. The basic Idea of 
the Arduino was to Incorporate a generic microcontroller and Its associated circuitry onto a standard 
form-factor device, to prevent unnecessary reinventing of the wheel eaclt and every time a project 
required some new automation hardware. The Atm el AVR was chosen as ihe microcontroller, mostly 
due to its low cost and ease of use. both from a hardware and a software standpoint. 

Beginning with the Arduino Extreme, the female headers along the edge of the Arduino 1 K'i Board 
have created tlielr own standard for building shields— that is, boards intended to be installed on top of 
(and in some cases, underneath) the Arduino I/O Board. It wasn't until the appearance of tire Arduino 
DieclmLIa that the final composition of the expansion headers emerged, by wisely including the -RESET 
line along with the power and ground pins of the Power expansion connector. 

The Arduino Uno has four sets of female headers along two edges of Its perimeter . (See Figure l -Li in 
Chapter I.) These headers are logically, electrically, and functionally divided Into four distinct groups: 
Port B (digital pins D8-DJ 3. AREF, and ground), PortC (analog inputs A0-A5), Port D (digital pins Dl) 
and D 1 , a.k.a. RX and TX. and D2-D7), and Power (Yin, two ground connections, 5V. Li r 2V r , and -RESET), 
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Each female header on the Arduino Uno contains either sjx iPort C and Power) or eight (Port B and 
Pori: Dj individual pins. The spacing between the female pin sockets is O.iOtf.The spacing between the 
top and bottom rows is l.flQO". The horizontal spacing between the connectors remains irregular and is 
discussed further In the next section, "The Mechanical Form Factor." 

The Arduino Mega 25611 starts with the same set of expansion connectors as the Arduino Uno, thus 
maintaining shield compatibility with its smaller sibling. (See Figure l-l I in Chapter i.j Because tire 
Arduino Mega 2561) has so many more general-purpose I/O lines available, additional connectors were 
added along the right edge of the board. Along the top edge, the communication, expansion connector 
was added, being the logical extension of the RX and TX pins of the original Arduino Uno Port D 
connector. The communication expansion header has transmit and receive pins for three more USARTs 
(TXI-3, RX1-3) along with two more pins from an entirely different serial peripheral, the TWI or PC bus 
connection. These pins are labeled SPA for serial del ui and SC L for serial clock. 

Additiona iiy. the Arduino Mega 2560 extends the Port C or analog input section by adding another lit 
pins for analog inputs AS-AJ5 P bringing the total number of anaiog-to -digital inputs from bon the 
Arduino Uno to 16. Note that the analog expansion connector (A0-A5] on the Arduino Uno contains only 
six pins, whereas the Arduino Mega 2560 expands this to a full eight pinson both analog input 
connectors. 

Bear Jit mind that any of the analog inputs can also be used as eiLhcr a digital input or digital output, 
just like on the Arduino Uno. 

And if that wasn't enough, the Arduino Mega 2560 also has an additional 36-pin female socket on 
the far right end of the board. This 2 x IB header contains 32 more general-purpose I/O lines along with 
two connections to both +5V and ground. That's a lot of I/O lines! 

The functional grouping of the additional pinson the Arduino Mega 2566 came at tire cosi of the 
logical assignment of ports to headers. The Arduino- specific numbering scheme used for addressing the 
individual I/O lines helps keep the signals straight. You can address each I/O pin using a single number, 
without regard to which I/O Port the pin belongs. 

The function of the expansion connectors is to provide both electrical and mechanical connections 
from the Arduino I/O Board to a shield containing application-specific circuitry. A wide range of shields 
arc available both commercially and as open source projects that anyone can build. 


The Mechanical Form Factor 

The very first Arduino prototypes filled up a small PC’B with just enough components to make a working 
microcontrol lei circuit. There wasn't a lot of extra space left over. Any circuit expanslnn was done on an 
expansion shield, which was stacked on top of the base Arduino I/O Board. 

The mechanical form factor has been preserved through many versions of the Arduino I/O Board, 
mostly to maintain shield compatibility' between releases, and not because It's the best of all possible 
arrangements. 

Looking at a modern Arduino I/O Board, such as the Arduino Uno or Arduino Mega 2560, you see a 
lot of spare room. This is mostly due to the continued miniaturization of the components that are used 
to implement the basic Arduino circuit. 

Although it makes sense, from one standpoint, to take advantage of newer technologies and 
processes, the perpetuation nf the classic Arduino form factor also helps those who want to undertake 
the journey of building an Arduino front the ground up with their bare hands, as it were. It's still entirely 
possible to design, build, and assemble an Arduino -compatible I/O Board using through- hate 
components, without having to resort to fancy robotic assembly techniques and mass production. 

A drawing of the mechanical form factor of the Arduino Uno is shown in Figure 4-7. 
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Figure 4-7. The mechanical [arm [actor of the Arduino Una 

All the mounting holes shown Lit the drawing have a diameter of 0.125" , or just over 3 mm. Note that 
the fourth mounting hole, at lower Left, was added when the ArduLito Uno and Arduino Mega 2 5 lit) were 
introduced and isn't present on earlier boards. 

Except for ihe Port B expansion connecter (at upper Left), aLI ofthe electrical connections on the 
Arduino tl.no are on a convenient 0.100" grid. For some undisclosed reason, this connector was spaced 
0.160" from the connector to its right. This spacing irregularity Lias been preserved to maintain 
compatibility with shields produced for earlier Arduinos. 


Universal Serial Bus (USB): Signals Plus Power 

Whereas the first Arduino I/O Boards used ao RS-232 connector and associated circuitry to talk to the 
rest of the world, modern Ard ulnos use the popular USB. This versatile Interface is an Industry standard 
and is maintained by the USB Implementors Forum, Inc. The USB specification and all other 
information relating to the USB standard can be found atwww.usb.org. 
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Hie changeover from RS-232 to USB was perhaps inevitable. Most modern PCs and laptops have 
omitted the once -popular RS-232 port in favor of the smaller USB port. USB-to-RS-232 adapters are 
available to Link older Arduino hardware to more recent PCs. 

One major advantage of using USB instead of RS-232 is the availability of a regulated 5V supply 
along with the communication functions. The USB specification allows an enumerated rf evict- (one that 
properly identifies Itself to the USB host, such as at) Arduino I i'O Boards to draw as much as 500mA 
ffl.5A] from this 5V supply. Unenumerated devices can draw a maximum of 100mA (O.10OA) of current. 

The first Arduinos to use a USB Interface Instead of the traditional RS-232 port were simply called 
Arduino (ASA. They were sold as kits, and you had to hand-solder the surface-mount USB Interface chip 
to the PCB. Instructions for the assembly process were published on the Arduino web site. 

The first USB interface chip used was the FT232BL from FTD'I, Inc. It provided a complete USB-to- 
serlal solution and required only a handful of external components. 

Starting with the Arduino NG and continuing until the Arduino DuemLIanove, the USB interface 
chip was another FTD3 product, the FT232RL. Tills chip Incorporated many more functions internally 
than its predecessor and required only a couple of external capacitors for normal operation. The 
FT232RL contains its own high-precision clock circuit, a 5.0V to 3.3V voltage regulator, and a factory- 
programmed unique serial number. 

Beginning with the Arduino Uno and Arduino Mega 256(1, the USB interface has been provided hy 
another Atm el AVR chip, the ATmegaSU2. It has a built -in full-speed USB peripheral, which the 
ATmega32fi and the ATmega2560 Lack. 


Summary 

Knowing a little more about the hardware on your Arduino HO Board enables you to better understand 
what it's capable of doing by itself and where it needs some help. Now that you have a grasp of the 
hardware involved and how to read a basic electronic schematic, go ahead and get your own copy of the 
hardware documentation that matches your Arduino from the Arduino web site, nntn.arduino.ee. This Ls 
the starting point for any additional circuitry you may want to add to your Invention. This is true 
whether you add a commercially available shield or design and build your own Interface. 

Now you move on from the Arduino hardware to the Arduino software. There's a good chance that 
yon may be spending some time using this software, so let's take a good looker Li and see what it's doing 
for you. 


CHAPTER 5 


Arduino Software 



The officially supported and free Arduino software is certainly a moving target. The alpha versions, 
ranging from the very first ti(K)l through 0G22, evolved as tire needs of the Arduino Team and the growing 
user base changed and matured. 

The goal of a 1.0 version [Aniuino If no Fit n fa Zero in Italian} was first announced on the Arduino 
blog on lanuary 1 , 20 1 0 (http: //arduino. cc^blog/lOlO/Ol/Ql/uno-piinto-zero), it was intended to 
coincide with [he continued growth and development of the Arduino hardware and become a reference 
version, ready to shed its preliminary status. The new generation of hardware, the Arduino Uno and 
A rd u in o Mega 2560, were announced at Maker Fai re New York City in September 20 10. 

At the time this edition of the book was going to press, the Arduino 1.0 software was still undergoing 
frantic work and testing. The Arduino- 1. Ob eta4 prerelease package was posted by David MeLIJson 
September 10. 201 1, and was the version used In the examples shown in this chapter. 

Arduino 0022, the Iasi of the alpha releases, was used it) the blts-and-byies analyses presented in the 
next chapter, it lias been a stable and dependable release, used by many thousands of Arduino 
developers all over the world. 

it has been suggested [bat the official release of the Arduino 1.0 software will he made at the 20 1 1 
Maker Falre in New York City, and by the time you read this, you'll probably know if this was true or not 

The new version contains many important internal enhancements, as well as a new visual theme. 
The Arduino logo, a composite of a stylized symbol for Infinity with embedded yin-yang- esq ue negative 
and positive symbols along with the Arduino name, represents the balanced comb Lnatlon of electronics, 
imagination, and Infinite possibilities. The new theme also features the recnmblnatlve use of 
multicolored Wares in a seemingly random arrangement, invoking a sense of motion, wind, or water, 
coming together in a slightly off-center stylized heart. See Figure 5-1, 
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Figure 5 - 1 . The neiv A rd ti in o splash screen 

Please bear In mind ill at the goal of this book is to provide you with a deeper understanding of die 
inner workings of both the ArduLno hardware and the Arduino software In general. The book won't be 
rendered useless when die inevitable improvements and enhancements are made to either one or the 
other. 


Open Source Software 

The Arduino software is really a collection of many different open source and free software packages. 
The Arduino software is licensed under the GPL version 1. although the component packages are 
licensed under a veritable rainbow of different ideas. 

The wonderful tiling ahoui open source and free software, besides the price, Is your access to the 
actual source code and underlying technologies. You’re not Just getting a black box that performs a 
single function. You're empowered to take the software to any new heights you wish. 

Found a hug? You can report It in the forum, or you can fix It yourself, If you have the wherewithal to 
do so. Missing a feature? You can add It. Kate the way program X does Y? You cao ad jus l it to your own 
satisfaction. 

By now you get the point. Consider following the example of the thousands of people who have 
contributed code, ideas, resting, and feedback to make the Arduino project the success that it ha-s 
become, and share brilliance with the whole world. 


Multi platform Support 

Perhaps one of the main reasons for the Arduino project's huge success and public acceptance is that 
virtually the same software is available for use on computer systems running Microsoft Windows, Apple 
Mac OS, or Linux. That covers a lot of territory! Alternative integrated development environments (IDEs) 
are being contemplated for use on tablets and sin art phones. 
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The one -size -fits -all magic Is due in large |>arc to ibe lava platform , which was designed from [be 
ground up to be as platform Independent as possible. Java, as a programming environment as welt as a 
computer language, has enjoyed tremendous success Ln the computer software marketplace. 

The Arduino software provides a complete Java environment, and a separate lava download isn't, 
required. 

The Arduino Heritage 

Where did the Arduino software begin? It was originally adapted from the Wiring project 

(http: //wiring, org. co), which was itself an AVH-based embedded development environment with a 

specialized user interface written in lava. 

The canonical wiring board was considered a bit of overkill for ibe most basic of beginner projects, 
as well as being beyond the fabrication skills of neophyte electronics hobbyists. The Arduino Team 
developed a smaller subset of the Wiring functionality and adapted both Lite hardware and the software 
to meet those needs. 

The Wiring project was derived from Processing (http: //www. processing, org), another open source 
collection of tools for writing Interactive and graphically oriented programs on a PC. This is where the 
idea of a software sketchbook for creative types originated. 

A very large body of work exists that explores the frontier between traditional, PC-based com puling 
and die embedded world, using Processing and Arduino In concert. This extends the standard idea of 
what properly constitutes a computer by moving into the physical computing platform arena. This 
allows for tangible, interactive devices that can embody rudimentary intelligence and emergent 
behavior while being both affordable and easy to reproduce. 

Installing the Software 

The Arduino software comes complete with everything: you need to write your own sketches, compile 
them using a state-of-the-art compiler, and upload them to a variety of Arduino -compatible I/O Boards. 
It also comes with an entire collection of excellent example sketches to help you get started with the 
fundamentals. There Is also a comprehensive set of libraries included that extend the capabilities of the 
built-in functions. 

The one thing the Arduino software does nor include is an installation program. Mo worries- none is 
needed. Simply unpack the supplied archive flic {.zip for Windows, .dmg for Mac OS X, and , tgz for 
Linux] into a convenient place of your choosing on your computer, and there it is. 

Uninstalling the Arduino software is just as easy. Can yem guess how it's done? You get one hint: 
erase the folder where you unpacked the downloaded archive file. Meed another hint? 


The Process, or “How to Arduino" 

The optimum way to experience the Arduino is to possessor have access to an Arduino I/O Board, the 
Arduino software, a moderately modern PC, and a USB cable. Oddly enough, the system is pliant enough 
that the PC is the only required component. The U SB cable is only one of many standard interfaces that 
will suffice. Alternate programming software and development environments are available. The strict 
definition of what constitutes Arduino-cnmpatible hardware grows more vague every day. 
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The starting conditions for using the Arduino arc- straightforward. Turn on your PC. Obtain and 
install file Arduino software, Use the USB cable to connect the PC to the Arduino I/O Board, and ioad the 
appropriate USE drivers f which depend on which Arduino hoard you have). 

The simplest way to gel started is to launch the Arduino software and choose the appropriate Board 
and Serial Port selections from the Tools menu,. The Arduino software maintains these settings for you. 

An array of example sketches is provided under the Files ► Examples menu Item. Start with Blink, by 
choosing Files.*- Examples *■ 1. Basics > Blink. The Arduino software Loads the sketch Into the editor 
window for you. It should bear a striking resemblance to 3 : igure5-2. 



figure 5~2, The Arduino software user interface, shouting the example sketch Blink 

Click the Upload toolbar icon. Doing so automatically compiles, links, and otherwise translates and 
prepares the source code you sec in the editor pane, transforming it into the ones and zeros understood 
by th e m J c ro con troll er o n t h e Aid u ino ho ard . 
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It' til] goes well, and it reaLly .should if you're using one of the example sketches, the Arduino software 
also automatically Labiates an uphtadaf the necessary Information to the Arduinn's mlcrocon trailer 
bra Lit. Once stored in the Ardulno’s program memory, the newly minted sketch Is n&nmlatite, meaning 
it remains there, unaltered, until it's subsequently overwritten hy the upload of another sketch. Il 
doesn’t require any power or batteries to maintain ibis memory. 

When the upload process has completed successfully, the sketch begins to execute. Unlike 
traditional computer programs that rut), perform some task, and then terminate, the sketch In the 
Arduino Is generally expected to run Indefinitely. In the case of the example sketch Blink, It most 
certainly does. It blinks an LED over and over again, tirelessly, faithfully, ad Infinitum. 

That Is the first phase of the Arduino dance. You can continue to try the example sketches, if you're 
curious. This should give you a taste of the variety of tasks the Arduino can perform. 

You have two Interesting options at this point. The first is to adapt an existing sketch to your needs, 
making small, iterative changes until It more closely resembles what suits your immediate purpose. The 
other option Is to start completely from scratch, designing a sketch that bears no likeness to any of the 
existing example sketches. 

This choice is up to you. 


A Tour of the User Interface 

The basic framework of tire main user interface remains the same from previous versions, as shown 
earlier In Figure 5-2. A single editor window dominates the screen, with traditional menu Items at the 
very top and a toolbar of icons directly underneath. A status area Is presented at the bottom of the 
screen. 

The main updates from previous versions are partly aesthetic and partly functional. The color 
scheme has been tweaked a hit, and the icons have evolved from their original pixilated line drawings 
into more visually identifiable symbols. 

The toolbar no longer responds to the Shift modifier of previous versions, which offered tire verbose 
output option for the compile and upload processes and the "...In a new window" option for the New 
and Open icons. The verbose options, which are exceedingly helpful in debugging, can instead be 
enabled In the updated Preferences dialog box, accessible from File Preferences. 

The Verify (compile) button Is now represented by a check mark instead of the Play transport- 
control theme. The ever-whlmsical Stop button has been eliminated. Did it ever actually do anything? 

The Upload button is immediately to the rigid of the Verify icon, now logically grouped by 
functionality. 

The New, Open, and Save Sketch buttons remain essentially the same. The New Sketch Icon looks 
tametvharYtke a blank page, but the up and down arrows of the Open and Save Icons remain baffling In 
their interpretation. Their contextual associations are non- intuitive. It's best to rely on the faithful 
mouse-over labels that appear in the toolbar, just to lie sure. 

The Serial .Monitor Icon has been moved to the far right of the toolbar. It shows what appears to be a 
magnifying- glass symbol poised over a horizontal trail of dots (or perhaps ants). 

The editor pane uses the same tab structure for organizing multiple open sketches. The tab control 
icoit operates In exactly the same marnaer but has received the same bolder refinement in appearance as 
the other icons: In addition h now points down Instead of to the right. The same keyword highlighting is 
used as in previous versions to help identify elements of the program, which can he of enormous 
assistance when you're looking for programmatic typos and those pesky syntax errors. 

The current line number of the editor’s cursor is shown in the lower-left corner of the screen. 

Most notable at first glance — to users of the previous software, at Icasi — arc the current settings of 
the Board and Serial Port settings on the Tools menu. This has been a much- requested feature from 
Arduino users. 
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Although the most common tasks are handled in tliie editing pane and via the toolbar icons, the 
remainder of the user interface is accessed thro ugh the menu system. There should be no surprises here 
for anyone who lias used an electric computing device within the last decade or so. The Ardulno 
software, for the most part, complies with industry-standard user Interface guidelines, even if It tends to 
overdo the cascading menus a bit. 

The official Arduino guide to the development environment is available from the Arduino web site,. 
wvjifti.ardaino.ee/en/CuideyEnvironment, as well as locally in the ref erence/e nvironment.html document 
in the software distribution. 


The File Menu 

This menu is where you work with your sketches when you think of them in terms of be ing/Ues stored in 
your computer's idea of an operating system. You can find the usual suspects here: New. Opeat, Save, 
Save As, Close, and Print. These options do exactly what you expect them to do. The Page Setup menu 
item Eels you make the most basic choices of page composition for your printed output. Including 
margin sixes and orientation (portrait or landscape], as well as some selections depen ding on your 
presently selected system printer, such as paper size. The Upload, New, Open, and Save menu Items are 
echoed in the toolbar icons just below the menu. 

In the File menu you also find shortcuis to your Arduino sketch book as well as a slew of excellent 
and enlightening example sketches 

You also find the Upload and ... drum roil, please... Upload Using Programmer menu Items. The 
Upload option Invokes the traditional Arduino bootloader process for most supported Arduino I/O 
Boards. The new option to upload using a programmer bypasses the bootloader method and writes your 
sketch directly to your AVR chip using the new programmer option selected in the Tools menu, 
described shortly. 

Probably here because they don't quite fit anywhere else, the Preferences and Quit menu items 
complete the tour of the File menu. The Preferences menu item brings up the Preferences dlatog box, 
where you can change some of the program's general seitlngs. Your Arduino sketchbook can be located 
anywhere you like in your computer's file system. The ske of the foot, but not the font selection itself, 
can be changed for the editor pane. 

The Preferences dialog box has been updated to allow you to specify the verbose output option 
explicitly, instead of depending on the undocumented Shift modifier of the toolbar icons or editing the 
cryptic and cleverly hidden prefercnces.txt file. 

The remainder of the Preferences ynu can alter remain the same from previous releases, including 
the file- extension association, which has been changed from .pde. following the Processing tradition, to 
.ino as Arduino Impresses more of Its own culture and Identity on the inherited software framework. 


Note Arduino sketches now have the . in a tile extension instead of the previously used , pde extension. 


The Edit Menu and the Edit Context Menu 

Again you have the typical populace of an Edit menu. Including Undo, Redo, Cut, Copy, Paste, and Find. 
These work much the same as In any other text-editing application. 

There are some nice additions, Including Copy for Forum and Copy as 3 ITM L, which Insert the 
proper formatting commands to preserve both the formatting and text highlighting provided by the 
editor. 
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There are also the same programmer’s editor functions found In previous releases* including 
Increase and Decrease Indent options, in addition, Comment/ Uncomment lets you hide large sections 
of selected code from the compiler as program comments by prepending the double- forward -slash 
single-line comment symbol to each selected line. Handy! 

The Edit menu tacks the keyboard accelerators more commonly found on Microsoft Windows 
applications. The editor Itself implements the ubiquitous Ctrl+X (cut), Ctil+C fcopyh and Otrl+V (paste) 
keyboard shortcuts, however. 

Right-clicking the mouse in the editor pane opens the edit context menu, which presents the 
standard editing options of the Edit menu. Missing are the Undo and Redo commands, but included is 
the handy Find in Reference option that searches through the provided reference hypertext 
documentation for the selected keyword and launches it in your default browser. 


The Sketch Menu 

You can find a short list of sketch -related functions in the Sketch menu. The Verify 1 /Compile item is 
duplk aied in the Verify toolbar icon. The Stop Item has disappeared, along with its corresponding 
toolbar icon. 

The Show Sketch Folder invokes an OS-dependent file-system explorer application that displays the 
contents of the otherwise- obfuscated working directory where the intermediate files created l>y the 
underlying software elves reside. This is a much simpler solution to quickly and conveniently locating 
these files when you need them* when compared to rooting out the location from the compiler s verbose 
output. 

The Add File option lets you copy another file into your sketch and open the file In a new tab within 
the editor pane. The import Library menu item inserts properly formatted ■# include directives into your 
code for use with any of the available Arduino libraries. See Chapter 10 for more informal ion about 
writing your own Arduino libraries, as well as an overview of ho w libraries are organized and 
implemented. 


The Tools Menu 

Here you find some Arduino- specific toots and access to their associated settings. 

Auto Format attempts to clean up the format of your code, enforcing consistent indentation and 
lining up the curly brackets when bean. It is, let's say, problematic at best. 

The Archive Sketch item offers to collect a)l the files Jo your sketch folder into an archive file 
appropriate for your operating system. This Is handy when you want to share your sketches with others. 

Mo one knows what the Fix Encoding & Reload function does. Perhaps you can he the one to figure 
it out first! 

The Arduino s Serial Monitor is meant to he a usefui serial communication tool for talking ro your 
Arduino over the same serial link used to upload sketches. It uses whatever serial port selection you've 
made In the Serial Port selection item , described shortly In this section. See Figure 5-3. 
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Pt&tir* 5J, The Arduina-s Serin! Mannar window permits you to communiotde with your Ardulna over 
the sethti part. 

It's not a linearly interactive aerial terminal, such asminicomor Tera Term Pro. To send characters to 
your Arduino, you type in the text box at the top of the Serial Monitor window and then click the Send 
button in send, or transmit, the text. Any information received from the Arduino is listed in the larger, 
non-lnteraetive text area that makes up the most of the center area. 

If your Ardulno seems to he emitting nothing but nonsense symbols or nothing at ail, he sure to 
confirm that they are talking at Lhe same rate, using the drop-down list box control in the lower-right 
corner of the window. 

The Serial Monitor can also be Invoked by the toolbar Icon on the far right. 

Don't be surprised if your Serial Monitor windows suddenly goes away when you upload a new 
sketch to your Ardulno. There Is only one serial port, and It must be shared between the uploading 
process and Serial Monitor, and only one of them can use it at a time. 

The Board selection menu allows you to tell the Ardulno software what kind of Arduino you have, so 
that it can make the right decisions about how to compile and upload your sketch for you. You can add 
your own, custom variations if you like. The entire process Is outlined In detail in Chapter 11. 

The Serial Port menu item lets you indicate which of your system 's available serial ports you would 
like to use. This Information Is updated every time you plug a USB -equipped Ardulno board into your 
PC, or unplug one. The process of notifying all lire interested parties can take a moment or two, so please 
be patient. 

Previous releases of the Ardulno software bad a Bum Bootloader menu Item on the Tools menu, 
which had its own cascading submenu nf selectable device programmers. This has been slightly 
rearranged in the Ardulno 1.0 release, with a separate Programmers selection menu and Burn 
Bootloader menu Item. 
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The Burn Bootloader menu Item uses [he programmer selected to property configure a blank AYR 
chip to be able to use the Arduinn bootloader process of uploading sketches over the serial port. This 
requires an additional device programmer to be used to perform the actual process,, which doesn’t 
actually Involve any sort of combustion. You can use your .Arduino as a device programmer^ this topic Is 
explored in much more detail in Chapter II. 


The Help Menu 

A wealth of helpful material is available to help answer your questions when working and playing with 
Ardulnos. The Help menu contains direct links to the most often- used resources. Much of the reference 
material Is provided in tire software distribution and is Located on your computer for fast and instant 
access. The Arduino web site (http://ardulno.cci is also available, featuring many more helpful 
resources. 


Summary 

fretting started with Arduino development Is easy. An enormous amount of work has been done to make 
this possible. The Arduino design process can be as simple or as complex as you need It to be, and the 
freely provided software is an excellent place to begin. 

It's far from perfect, built's a great start. You're encouraged to make suggestions, provide 
constructive criticism, help with testing or documenting, and in other ways contribute to the project in 
any way you like. The Arduino Team doesn't live in an Ivory to wer, capriciously deciding what gets done 
and what doesn’t. They're energetically engaging the Arduino community, asking for suggestions, and 
implementing a steady flaw of improvements to both the hardware and software over time. Your 
feedback and creativity are truly needed and appreciated, 

The next chapter looks at areas where you can improve some of the performance aspects of the 
system. There are many possible optimizations you can make when you have a better understanding of 
the Inner workings of the hardware and the software. 
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Optimizations 



As shipped, the Ardulno software Isn’t especially optimized. It's easy to use and simple to install, but 
there Is certainly room For Improvement. Let's get started. 

Three areas scream out for optimization in any embedded development project: program and data 
space, program execution speed, and system power requirements. Ideally, you want the smallest 
program running as fast as possible using the least amount of 'power. These cFforts translate Into 
simpler, cheaper, and more reliable products. In reality, there is almost always some sort of compromise 
among these three areas, depending on the needs of the project. 

This chapter presents a lot of Important technical Information, grouped into topics. You're not 
expected to read and digest all this information in a single sitting. Pick out the topics that interest you 
now and give them a good skimming. File the other headings under ’’ Future Reference" and come hack 
lo them when you need some optimizations of those kinds. 


How Will You Know It Worked? 

You measure the rate of a blinking LCD using Just your hare eyeballs. For more detailed measurements, 
you need some different tools. Performing these measurements in your own Lab is encouraged hut not 
mandatory. 

Some of Lhc optimizations wilt be very easy to measure. Space-saving optimizations result In a 
smaller file size. Because the Ardulno software reports the resulting binary sketch size after every 
compilation, It’s easy to see If the file got bigger, got smaller, or stayed the same size after you applied a 
particular optimization. Space-saving optimizations are Important because they let you pack more 
software into your chip, before you have to move up to a higger (and probably more expensive) device. 
The available program memory in your Ardulno is one of Its most precious and limited resources. 

Lei’s try a couple of simple optimizations to see if you can reduce the size of one of the example 
sketches. 


Note Don’t overwrite the sample sketches provided with the Arduino software. If you make changes to the 
example sketches (available via the menu selection File > Examples) and want to save them, choose File ► Save 
As and give them a new name. Having known working example sketches available is very handy when things start 
to get Really Weird. 
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Shrink Blink 

Let's see whas you can do with your old friend, Blink, found In File x Examples > I. Basies X Blink. 
Complied for the Arduino Uno using Arduino 0022, tire resulting binary sketch size is l,0i£ bytes i.oi'a 
32,256-byte maximum}. The same sketch, when compiled for the Arduino Mega 2560, results In a binary 
sketch size of J.5J3A bytes (of a 25f5,04S byte maximum). The extra size can be attributed to the 
initialization of the larger number of available peripherals aboard the ATmega256D chip along with the 
additional low- level functions needed to talk to them. 


How Blink Works 

When you look at it a certain way. the Blink example sketch only does three things: 

1 . Co n fig n re d igi t al pin l 3 as a n o u t p u i. 

2. Change the state of the output pin. 

3. Pause for a hum tin -percept! hie a mo u n t of time r and then repeat from step 2. 

Because Blink Is an example sketch In the 1. Basics category, Ji makes no attempt at optimization. Its 
goal is he easy for both the Arduino compiler and the beginning Arduino programmer to understand. It 
says what it does and does what It says, which is always a good thing. In furtherance of this plainness 
and simplicity, Blink spells out the discrete commands to turn on the LED. wait, turn off the LED, wait, 
repeat. 

Turning tire LED on and off can certainly be accomplished with the code as presented in the Blink 
sketch, but it can also be looked at, in a more abstract sense, as foggff'ngthe LED output. If it’s on, turn It 
off, and vice versa. You use this concept shortly to cut the size of the loopf ) function in half. 


Measuring Space-Saving Optimizations 

Edit the Blink example sketch using the Arduino code editor. In the set up () function, add two forward 
slashes (//) to the left of the pin.HodcO function call. In the Arduino IDE, this modification turns the 
color of the pinnodeQ statement from orange (executable code) to gray [program comments). 

Everything following the stttgle-Une- comm cm marker (//) until Lite end of the line is considered a 
program comment and Ignored by the compiler. You could have deleted the entire line, hut you might 
want it hack shortly For more experiments, so just comment It out for now. This is a useful technique for 
making small changes to code to compare behaviors, before and after. 

Compile the code to see what happens. On the Arduino Uno, the binary sketch size drops from 
LDU1 bytes to 934 bytes, Just by commenting out the pinMode( ) function call In the setup() function: a 
space savings of B4 bytes. For the Arduino Mega 2569. the resulting binary sketch size is now 1,594 bytes, 
showing an Identical reduction of B4 hytes. This is explained by the omission of the plnModeQ function 
call, containing fl bytes, as well as the code for the function itself, containing 76 bytes. Because there was 
no other reference to the pinModeO function lit the program, the compiler wisely omitted the 
instructions that perform the actual task from the final binary sketch. This form of space-saving 
optimization has already been done for you, but there is more that you can and should do to get the 
most out of the lint lied program memory space. 


100 


CHAPTER 6 QFTafilZftriOME 


Code Analysis 

The call to the pinhodcO function required a total of eight bytes of program memory. The CALL 
instruct Jon Itself takes four bytes* or two Instruction words. Remember that allAVR machine- language 
instructions are a multiple of IS bits Jn length, and each byte contains fl bits* so It always takes at lease 2 
bytes of program memory for each machine-language instruction. The subroutine CALL Instruction is 
two program words Long. The shorter Relative Call iftCALL) Instruction could itavc been used here, 
because the relative distance from the calling program to the subroutine happens to he within the 2KB 
program word li ml t of the Jt£A LL ins t ruction . In a la rger p rograin * h nweve r, the CAL L instr uct In u may 
he required. There is no simple way to cell this compiler to use the shortest instruction possible in 
every case. 

The other four bytes In the pinMode(] function call arc taken up by the two eight-bit parameters that 
are passed to the function: the pin number Uj] and the direction (OUTPUT). Each parameter Is loaded into 
a predefined register before the actual function call is performed. Each of these constant urafue 
parameters Is loaded Into a register using the Load Immediate (LDI) Instruction, which Is one program 
word (two bytes') long. The compiler knows if you're using constants (as opposed to variables) so ii can 
easily decide to take this shortcut; tills Is another optimization provided by the compiler that is already 
working for you. 

You maybe thinking at [bis point that you have completely disabled the humble blink sketch l>y 
failing to configure the one output that It needs to perform iLs simple function. This Isn't entirely true. 
Try compiling and upload ing the sketch to your Arduino, minus the pLnHode() function call, and observe 
what happens. 

In a brightly Lit room or sunlit area, you most likely won’t see anything happening. However, this 
isn't precisely the case. Try observing your Arduino In a darkened room, or wait for the sun to go down. 
You see Lhat Lite LED attached to D I ii Is indeed blinking, albeit very dimly. This is because writing a HIGH 
or a LOW value to a digital pin that is configured as an Input causes the built-in pull-up resistor to be 
activated or deactivated. Even though you didn’t explicitly configure Din as an input, this is the default 
stare of all general-purpose I/O pins after reset. The LED is being powered by the very small amount of 
current flowing from V M through the pull-up resistor, which Is typically only a small fraction of a 
mill lamp. 

Although a dimmer LED saves power, U r s not saving you any program space* per se. Let’s replace the 
functionality of the pinMedeO function so that DL3 can be configured to be the output it always dreamed 
of being. 


Life Without pinModeQ 

Setting the direction of an 1(0 pin Is a very straightforward procedure on the Atmel AVR. Recall from 
Chapter 3 that each of the general-purpose I/O pins belongs to a group called a port t and each of the hits 
within a given I/O port can be either an Input or an output. The direction of each of the Individual pins Is 
controlled by the bits within the data direction register (OBRx) associated with the I/O port. 

Arduino bides all this complexity from you aiid numbers the digital pins starting at zero. The analog 
pins are likewise numbered. Arduino programmers don't need to worry about ports and addresses and 
bit positions. You just look at the Arduino I/O Board, find the pin you want to use, and use the number 
printed on the printed circuit board I'PCBl. It's quite handy. 

Because you know that Dili Is PB3 [Pori B, bit S! ou the Arduino Uno ami PB7 (Port B, bit 7) on the 
Arduino .Mega 23tiG, you can directly set the single bit in Port B'sdata direction register (DDRiS, bit . 5 or 7, 
depending! and get the same result as the pinMode( ) function call, without all the program overhead. 

[f you have an Arduino Uno or other ATmega32fi -based Arduino* add thestatement 
S); to the setup( J function of the example Blink sketch. If you're using an Arduino Mega 2360, add 
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bit^et(DDRBj, 7); to the setup() function. For the Arduino IJno, your setup Q function should now look 
tike Listing 6-1. 


Listing 6-J. Directly Setting the Direct fan Bit of an BO Bon With on i Using the pint4od&() fit net ion 
void setup() { 

// initialize the digital pin as an output, 

ft Pin 13 has an LED connected on most Arduino boardsi 

//pin Mode (13* OUTPUT) ; 

bitSet(lD€R6j 5); // £>13 (PB&) is now art output 

} 


Compile and upload to your Arduino. You should have a properly blinking LED again, hut the binary 
sketch size should he only 936 bytes. The bitSct^DDfiB , 5) ; statement Is reduced to a single instruction 
(two bytes) by the compiler- — and it works. 


Tip Because you've replaced a somewhat human- readable program statement, pinModc{ 13 , out put), with 

complete bafflegab and abracadabra, it's more important than ever to use clear, explanatory comments in your 
code. 


Abbr. & Shrtcts 

There a re several things you need to know and understand about the little code modification just 
discussed. First, the original designers of the C programming language were prerty Ja-zy efficient when it 
came to typing. If you've ever spent much time working with a Teletype AS ft -33, you may begin to 
understand why. It wasn't exactly a pleasant experience. The designers came up with many shortcuts to 
help reduce the amount of typing required to perform most functions. 

The second thing you should know about lire replacement configuration statement is that it isn't 
truly a function call, even though it looks like one. Tire bitSct() function is really just a macro definition, 
defined in the wiring . h header file that is Included into your sketch, along with the other Ardulno- 
supplled code, before being complied into the final binary sketch, ready to upload. This function takes 
two parameters, value and bit. These parameters are then substituted Into a prewritten mathematical 
formula, f (value | - ( lUL « (bit) ) ). When the substitution is complete, the resulting statement 
effectively reads as PPR13 | - i<<5, which means "Set bit 5 In DDRB." 

The wiring. t and wiring Ji files also provide several other hit -manipulation macros that often can 
be reduced to a single instruction, including bit Clear (), bitkead(), and bitUrlf e(), See the Arduino 

Reference page (choose Help > Reference Jo the Arduino software] for more Information about these 
functions. 

The DDftB [ = \ statement is a good example of the possible compactness of the C language. 

Technically, tills Is an assignment statement. The |= operator Is called an augmented (or compound) 
assignment operator. It’s augmented because It's a composite of the assignment operator - and the 
bitwise, Lneluslve-or function, represented by the vertical bar character |. The statement could have 
been written M>RB = DDfiB | Spelled out, this translates as "Read the value that is currently In 

the DURB register, bltwUe-or this value with tire constant value l«5, and then store the result back In the 
DORES register.” 
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The term DDRB b used twice in this statement: once as a source (as one of the operand# and once as 
a destination. Oat the [eft side of the equals sign (*] is the destination, or ft'iihde. On the right side Is [he 
source, or rvalue. In cither case, the DBRB term represents an address in I/O space. It's defined in the 
avrVio.h header file, which is included automatically by the Arduino software. Actually, the avr/io .h 
header Ule is just a generic header Hie that looks at which part has been defined as being used: for 

example. AVfi:_Al«ega25&0 | is a symbol that is defined in the code when the Arduino Mega hoard 

is selected by choosing Tools > Board. 

With ail this p redefinition of terms having already been put in place, you cat) refer to 00R.& like 
any other variable In [he program. It can be read, written, or modified just as any other numeric value 
cart he. 


Binary Notation 

The 1<<5 notation needs some explaining. This is an example of the left-handed bitwise shift opera tor at 
work. The 1 on the left side is a coirs tan t, representing a single, digital I in the least significant binary 
digit. The 5 tells the operator how many times to shift the bits leftward. The corresponding right -banded 
bitwise shift operator In., you guessed it, written ». The 5 is used because you're interested in bit 5 of the 
UDRB register, which corresponds with the fifth pin of the Pori b general -purpose I/O port, PBS. 

Shifting a bit to the Left in a binary number Is the same as multiplying it hy two, if you shift a decimal 
base 10) number to the left (and add a zero to the now -empty space on the eighth it's the same as 
multiplying that number hy 1 0. Binary numbers are exactly the same as decimal numbers, except they're 
base 2 instead of base 10. Inside the computer chip, all numbers (and all data, realty! are represented hy 
binary numbers. 

So instead of l<< 5, you could use decimal 32 iDDftB = 32 1 ), hexadecimal 0x20, octal 040, or binary 
ObOOlOOOOO. Unfortunately, none of these other [perfectly accurate) representations readily 
communicate to the reader that you're interested in hit 5 here, and only bit 5. The binary representation 
D bOO 10000 0 comes close but is more error-prone and takes much longer to type. The compiler 
understands them all, and they end up as the right hits In the right places after all the dust settles. 

Couldn't you write l<<5 directly Into the DDRS register and he done? In this trivial example, yes. You 
don't care about the values of tire other bits in DORR, and writing a single hit (bit 5) clears all the other hits 
as an unintentional byproduct. Because ibis is a trivial example, it doesn't matter. Setting or not setting 
any of the other hits In that particular register doesn't affect the desired outcome. 

Using the bit Set () macro instead of either the direct assignment statement or the augmented 
assignment statement makes the source code clearer in its intent, without Incurring airy sort of size 
penalty or code bloat. The compiler reduces it to the smallest code possible. When it's within the range 
of the bit-manipulation instructions SBI and CBI.it uses those. Otherwise, It cobbles together something 
brief. 

if ihe l<<5 notation just isn't your thing, you can use the Arduino -provided bltQ macro, which does 
the same thing. For example, 1^5 can be written bit[s). 


Further Analysis 

As just mentioned, you could simply write the desired value directly into the DDRB register, treating it just 
like any other variable. You'd do so with a statement such as 0DR6 - This works because, in [his 

example, you don't especially care if you clobber all the other bits in the DDfiB register. You only care if 
the rift Ei bit gets set. 
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One Interesting note about writing a value directly to the register (instead of the read/ modify /write 
procedure used with the augmented assignment operator) is that the binary sketch size is now 936 bytes* 
nr 2 bytes bigger than the preferred method, using the bitSct{) macro. This Is hecause the compiler uses 
two machine-language instructions to perform tins direct write: one to load a constant value Into a 
register* and another to write that value to the I/O port. There Is no Load Immediate (LOT) instruction 
that directly addresses the I/O space. The binary sketch size on the Arduino Mega 2560* likewise, is 1,51)6 
bytes* one machine- language instruction longer than the more compact version. 

How, exactly, does the compiler perform this bit of magic? The answer lies In the highly optimized 
AVR-speeiflc libraries that are provided with the Arduino software. They're part of the AVR port of the 
GNU Compiler Collection (avr-geej and collected together into fheavr-libc library. The compiler 
determines that only a single hit is being manipulated and uses the exact machine- language instruction 
that was created specifically for this Job: Set Bit in IO Register (Ski). The S6I instruction performs the 
com plete read /modify/ write process in two clock cycles but only uses a single word of program memory 
to do it. 

Thai’s not all you can optimize in terms of space in this example. Let’s further use your 
understanding of the Internals of the At me! AVR to optimize the blinking of the LED. 


Easy Toggling 

As discussed previously regarding the example sketch Blink, the LED is explicitly turned on and then 
explicitly turned off again, using two different forms of the digitalldrite( ) function. The first function 
call turns on the LED by writing a HIGH level to pin Dlfi, and the second function call turns off the LED by 
writing a LOW level to the same pin. 

Also mentioned previously is that this on-again, off- again cycle can he more abstractly viewed as a 
toggling of the output pin. Luckily, the AVR knows how to toggle the output of Its pins using a special 
write sequence* using an otherwise unused address. 

The Input Pins Address (PlMxj is normally only ever read by the processor* to determine the actual 
logic levels present on the general-purpose I/O pins. 


Tip Don’t make the mistake of trying to read the port* register. This is the output port data register only and 
only indicates what value, if any, was last written to tire output port. To read inputs from the outside world, you 
must read from the PLMx register. 


When the AVR design engineers decided to add pin-i&ggltng capabilities to the newer AVR chips, 
they didn't have any extra I/O addresses to use, so they cleverly reused an address that had only been 
used previously for inputs. Writing a l to a hit in the iPlNx register or toggles the output level of the 

corresponding output pin for that port. Note that this doesn't work on alder AVR devices* such as the 
ATmegaS. ATmega 1 6 , and A.Tmega32. When In doubt* check the datasheets. 

To toggle the LED. you Just need to write a single l to the correct hit position in the P1NB register. 

You don't need to preserve any of the other bits in this register, beta use they technically don't exist. 

Replacing both of the digitslwritef) function calls with bit5ct(PINli ) 5>); results In a binary sketch 
size of only S58 bytes for the Arduino Una and 870 bytes for the Arduino Mega 2560. Please remember to 
use 7 instead of 5 when using the Arduino Mega 256*1* because D13 is mapped to PB7 and not PBS. 

This results in a slimming of 276 more bytes. The digitalWriteQ function Is handy* but it comes 
with a price. 
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Further Reduction 

A closer look at the resulting code reveals a duplication of efforts. Whereas the original version of Blink's 
loopO function contained four program statements to perform the discrete steps Involved, the new 
version needs only two: the first to change the LED state, and the second to wail a short period of time. 
Because the loepO function automatically repeats itself, It turns on the LED after one pass and then 
i urns off the LED on the next pass. 

Eliminating the now- redundant lines of code produces a h inary sketch size of 644 bytes, a further 
saving of 14 hylesof program memory. 


Wasting Time More Efficiently 

What's left to optimize In this sketch? The only function calls you haven't modified so far are the delay ( ) 
function calls that produce the human- perceptible delay you need In order to Ire able to detect the 
blinking of the LEDs with the naked eye. 

lust to establish a lower boundary, comment -out the remaining delay () function call within the 
loopO function. When compiled, this produces a binary sketch size of 454 bytes. This is the lower 
boundary for the binary sketch size because no code for the delays lias been Included at all, and It will 
take something to replace that functionality. Let's look at a couple of alternatives. 

First, let's try a simple for() loop to kill some time. A for() loop is a special kind of control {that Is, 
looping! structure. A forQ loop contains a place for some initialization code, a place for a test to see if 
the loop should continue, and a place for some code to perform every loop. These code snippets are 
included as the parameters of the f or {) statement and are separated by semicolons. 

Add the program statement for (in. t i = Oj it 32000; i++); somewhere inside the leopO 
function. It really doesn’t matter where you place this statement in such a simple example program. 

Suspiciously, after compilation. Lite binary sketch size is sn7M54 bytes. Uploading the sketch to your 
Arduino produces perhaps puzzling results. The LED comes oit and appears to stay on, but it looks a 
little dimmer than before. In reality, it’s blinking away madly, more than half a million times per second. 
This Is much too fast for the human eye to detect and looks like a blur. What happened? 

Optimization happened, that's what. The compiler spied your empty f oi() loop, which contained 
no executable statements. The compiler then decided that the for{) loop wasn't needed in the final 
program. Therefore, the compiler completely omitted the for() loop, thinking it bad done a Good Thing. 
Remember, the compiler takes optimization very seriously and doesn't understand you wanting to waste 
time like that. 

Add the keyword volatile Just before the integer type declaration int to prevent this optimization. 
This produces a 49B-bytc binary sketch (a good sign, because it's bigger) and, better vet. a rapidly yet 
visibly Hashing I.ED. The volatile keyword Instructs the compiler to make no assumptions about this 
particular variable, including assumptions that might have lead to optimizations. 

The parameter passed to the Ardulno’s built- In delay {) function is the desired delay time expressed 
in milliseconds. The parameter selected in your for() loop is Just a big number and doesn't directly 
correspond to milliseconds. By giving up this accuracy, you save 146 bytes of program memory. This is 
figured by offsetting the 190 bytes you saved by omitting the delayf) function by the 44 bytes taken up 
by the empty for{) loop. 
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Using Lower- Level Code 

Another approach to adding a perceptible delay is to use the already-ticking TlmerO and its associated 
interrupt handler, TlrHERO_0VF_vcct, which increments an unsigned, Enng integer value called 
timero mi II is. 


Caution If you m e ss with improve the built-in Arduino code that uses the timers, you risk losing the proper 
function of the built-in timing functions, such as delay{ ) , minis ( ) , anti so on. 


To refer in this new variable in your sketch* you need to add an external variable declaration. The 
variable tiaerOjnillis k defined in the wiring. c source code, hut the compiler forgets all about It when 
it has completed the compilation of that source file and moved on to the next file to be compiled. You 
remind the compiler about this variable by adding the external variable declaration extern volatile 
unsigned long tlnerojnillis; somewhere In ynur sketch hut outside either of ynur two functions* 
setup() and loop().Thls declaration needs in be placed somewhere In ynur sketch before the first 
reference Is made to the variable. In other words, it has to be defined before it can be used. Also note that 
ibis declaration must match the definition in tbe other file exactly. You can’t say it's an int in one place 
and a byte in another, nr the compiler will become confused. 

Now replace the empty for 0 loop with the following two progrant statements inside the loop( ) 
function: 

whiLe(ti#crO_millis c 1QQ0); // wait l second 
tintcrOjrdllis = Q; // reset millisecond tiaer 

Tbe first statement Is an empty while {) loop ibat waits for tlrterd_millis to equal nr exceed the 
value 1,00*0. Because timer fljtilllis should increment at the rate of one count per millisecond, this loop, 
excluding any code overhead, should take approximately one second io complete. It won’t be exactly 
one second, but Ji will be very dost.-. When tbe while() condition Is satisfied, execution continues with 
the next program statement* which resets the millisecond timer count. 

Do take note of the fact that this counter -resetting method completely nullifies the intended 
operation of the eiLLisf ) function, which is to report the cum ulaiive number of milliseconds since the 
Arduinn sketch began to execute. Because this Is a trivial example, and all you want Isa one-second 
delay, you can take this liberty. 

Compile and upload ibis sketch to your Arduinn. This alternative delay results in a binary sketch 
size of bytes on the Arduino Unn and 706 bytes on the Ardulno Mega 2560, even smaller titan your 
empty for () Loop delay method. Had the lower-level Arduinn code not already initialized TimerO and 
provided an Interrupt routine, yon would be required to do so yourself, and the code would be 
correspondingly larger. As it is, you have creatively used tbe existing software to do your bidding, at the 
expense of the original Intent of themlllisO function. 

lit summary, you've replaced three function calls and cut the binary sketch size by more than half, 
in truth, there's still more to cut, because a Lot of unused functionality is waiting to be exploited in a 
plain- vanilla Arduino sketch. 
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Saving Space with Simple Serial Communication 

Tiie Arduino's Serial library is very convenient and does a fot of different, useful things. In Chapter 2, 
you successfully ported the classic C program "Hello, world!” to the Arduino and replaced printfQ with 
Serial, pr intin (). Sometimes, however, you only need in send a few simple messages or report a 
reading or two. In these situations, you may want to save some program space by replacing Serial with 
the hare minimum of code necessary to send or receive data. 


Nate Baud rata ar Ms per second (bps)? Technically, these terms don't mean the same tiling, although 
they're often used interchangeably. Both the Arduino and Atm-el documentation use baud when they more 
properly mean bps. 


Let's bypass the Arduino's Serial library and write directly to the US ART peripheral. 3n doing so, 
you lose a for of functionality but should regain some program space. Create a new sketch for these 
experiments. To begin, add to the setup (} function the two lines shown in Listing 6-2. The loop() 
function must be Included as well, but you don’t need anything in there just yet. 

Listing 6-2. “Hello, World!” Using the Arduino Serial Library 

void setupO { 

Serial. beg ln(960O); 

Serial. println ("Hello, world! n ); 

} 

voi-d LoopO { 

// nothing to do here 

} 


Compiled with Arduino 0022 for the Arduino Uno, this two- liner translates Into a 1,906 -byte binary 
sketch. The Arduino Mega 2560, as you might expect by now, results in a larger binary sketch dial weighs 
in at 2,741 bytes. Let's see what you can do about reducing those numbers. 


What "Hello, world!” Does 

Breaking down the "Hello, world! 71 sketch is even easier than the Blink sketch. You're down to just two 
ma jor operations in this example: 

1. Initialize the serial port to the correct com in unication format and data rate. 

2. Send a s tr ing of cha racters o u 1 1 be se ria 1 po rt, a n e at a tl me . 

On the Arduino Uno, only one hardware USART peripheral Is available, called USARTG, and It's 
already connected to the USB interface that pretends to be a serial port on the PC. This makes the 
"Which port do I use?" decision simpler. On the Arduino Mega 256a, there are four USART peripherals 
built-in, and USARTO is connected to the USB interface. 
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There are several registers associated with each USART peripheral. These registers are lire way you 
communicate with the serial port Jit [he sketch. The Arduino Serial library knows all about them and 
even adds additional capabilities hy using the available interrupts that can be generated by [he USART 
hardware, permitting serial transmission and reception to be performed in the background using a sec of 
circular buffers. That’s great if you have the extra room tn accommodate all that code. If you're adding 
serial communication features to an already- full cli Ip, you may not. 


Writing to Configuration Registers 

The AVR USARTs are very flexible peripherals and have many configuration options available. You need 
to write to four of these registers [UCSROA,. UCSRO&, UCSftoC, and UBRRQJ to get everything running smoothly 
for your sketch. Each of these registers contains discrete bits that configure particular aspects of the 
USART, 

Instead of a long list of b it Set ( } and bitClcarO macro calls [which would work hut would end up 
being unwieldy and error-prone), let's write all the bits to each of those registers, one whole register at a 
time. You can use a trick similar to the hit- shifting fun you had hack in the "Shrink Blink" section to set 
each bil r by name, to either a one or a zero, as appropriate. Yes. even the bits have names. The names of 
the hits and the registers are already defined in one of the header files tbai is automatically included by 
the Arduino software, so you don't have to look them up in the datasheet. 

First, to get a lower bound for your experiment, comment-out the Serial, begin () and 
Serial., printlnO function calls. Doing so effectively guts the sketch as far as functionality, but it still 
compiles with no errors. On the Arduino lino, it should result in a binary sketch size of only 450 bytes. 
The Arduino Mega 2560, likewise, needs 662 hytes to wake up Jit the morning but not get anything done. 
Add the following three lines to your setupf) function: 

UCSftOA = OccTXCQ I 0«U2XO | 0«MPCM0; 

UCSRGB = OcdtXCIEO I 0«TX£iE0 I OccUDRIED | CkcKXENO I KeIXENQ I 0<<Ut£2D2 I a«TXBS0; 

UCiftOC =■ £k<UMSELO.i CkdJMSELOO | OccUPMOl | OceUPHOO | 0«UEBS0 | UcUCSZGl | UiUdlQO | OcsUCPOLQ; 

If you're feeling especially lazy, you can type in these shorter lines instead: 

UtSftQA =■ 0 ; 

UtSftOB - l«TXEhH>; 

UCSftQt = i«UCSZ.01 i l«UCS2Ci0; 

These shortened versions take advantage of the fact that the omitted bits needed to be set to zero, 
and that's exactly what the compiler puts in those hit positions unless otherwise Instructed. If you go 
ahead and type in iJ U those umrds, you’re rewarded later when you want to go back and tweak some of 
the other USART settings, otherwise you have to go back to the datasheet and look up alt the hit 
positions. 

You must, however, w r rite a 0 to the UCSRQA register If only to intentionally clear the U2K0 bit, which, 
when set, doubles the transmission and reception speed. Tire LJ2XO bit is set by the Dptlboot bootloader 
after the chip Is reset and remains set after the sketch begins to execute. If you omit that, you're going to 
get garbage characters in the Serial Monitor window, because the baud rate isn't what you think it is. 
Note that you haven't set the actual baud rate yet— that will happen shortly. Even if another bootloader 
is being used, it isn't a good idea to make assumptions about the starting state concerning hardware 
configuration. 

The other bits In UCSfiDA mostly reflect the current status of the device. You learn more about the 
details when you actually get around to sending some data. 
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The second ] Lnc enables the USART transmitter, l>v setting the TXEM&blt within tbeUCSROB register to 
l. because you're only transmitting and not receiving, it isn't necessary to enable the receiver (by setting 
b it RJi E No to a lj. Enabling the transmitter actually routes the USART output pin directly to the I/O pin on 
the chip package and disconnects the general- purpose I/O line. Note that you don't need to explicitly set 
the pin to bean output, because this Ls taken care of automatically in the hardware. 

The other hits in the UCSHO0 register enable or disable the possible interrupts rbatean be generated 
hy the USART hardware, including Receive Complete, Transmit Complete, and Data Register Empty. 

You don't use any interrupts in this simple example, so all of these other bits can remain set as zeros. 

There as one other configuration bit in 9CER06 fUCS202> that, along with two other bits in the LKSfiOt 
register (UtSZOl andUCSZOO) determine the number of bits that are transmitted with each byte. As luck 
would have it r the U CS202 hit should he set to zero to configure the serial port for eight data bits, which is 
what you want. The Arduino software assumes a serial port configuration offiKI, meaning eight data 
hits, no parity hits, and a single stop hit. 

UCSROB also contains a couple of hits I'ftxUSO and 1X030) for sending and receiving a possible ninth 
data hit, which Js sometimes required by certain serial protocols. The AVR USART hardware Is quite 
versatile, indeed. 

You set the remaining data -size lilts uCSZoiand UCS2Q0. in the third configuration statement. They 
hoth need to be set to l to Indicate that eight data bits should be transmitted and received. The serial 
data format can he anything front five to eight data hits long. 

The only remaining configuration task is to set the baud rate. This is accomplished hy providing a 
number to he used as a prescaler, or divisor for the system clock. The resulting clock signal should be 16 
times (16x) the actual baud rate. This is because the USART omrsamples the incoming data stream to 
help eliminate errors due to intermittent line glitches. The formula for determining the baud-rate divisor 
comes straight front the AVR datasheet. 

Instead nf wedging yet another magic number into the code, you spell out what you're doing using 
macro definitions. Add the following two lines just above the setups ) function: 

ffdcfine BAUQ_RATE 9600 

ffdefine BAUO_&ATEJJlVISOfi (F_CPJ / 16 / 0AUl>_RATE - i) 

F_CPU is a predefined symbol that represents the frequency of the CPI), in the case of most Arduinos, 
this ls 16,000,000, which represents the CPU frequency in cycles per second, or Hertz, in any case, It 
should be correctly defined, and you can rely on its correctness so that you don't have to alter your 
source code every time you want to try it on a different Arduino. This is one of the many parameters that 
gets set when you select your specific Arduino model by choosing Tools > hoard. 

Now if you want to change the baud rate from 9606 to something else, you know where ro go. 

To configure the USART to operate at this communication rate, add the following program 
statement to your setupf) function: 

LiBRftO = BAUGJtATEJJLVlSDR; 

Your USART is now completely configured. It took only four program statements. Note that the 
binary sketch size for the Arduino l.Jno is only bytes, compared with 1,372 bytes had you used, the 
ever- mo re -convenient Serial, begin (9600) function call. The Arduino .Mega 2566 is a tittle heavier, at 
690 bytes, instead of the previous 2.206 bytes using the Serial library. 


Transmitting Data 

To transmit a single byte of data, you write an eight-bit value to the LM>Ro register. That's all there is to It. 
The USART hardware does the rest for you. 
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You need to wall until tbai character get* transmitted before sending another one, however. To 
determine when this has happened, you interrogate the USARTO Data Register Empty (UDJtEQ) bit in the 
UCSROA register. When this bit is set, Li means that the USART's Internal transmit buffer Is empty and 
ready for another byte. 

Listing fi-Li contains a simple function to sc tad a single character via the serial port. You can add this 
function anywhere you want within your sketch, but If you add it before It's ever referenced by your other 
code, you can omit the otherwise-required function p rototype that clues in tine compiler as to the 
function's parameters and return type, if any. 

Lifting A Function to Transmit a Single diameter uia the USART Peripheral 
void usart_putc (char c) { 

Loop_untiL_bit_is_set(UCSI<:OA J UDREfl); U wait for transmit buffer to be empty 
UDfiG - c; // transmit character out the serial port 

} 


Front the function declaration, you can see that the function takes a single char (eight-bit value) as 
an input parameter and doesn’t return a value (void). 

The loop_until_blt_is_set £) function Is (as you probably guessed) not a function at all, but rather 
yet another macro definition. This one is provided by the avr-Llbc library. You could have also used [he 
Arduino -sup plied bitReadQ macro Inside an otherwise-empty i^hileO loop, which produces the same 
executable code: 

ile ( bit Read ( DCS Ro A , UDR Eo) ) ; 

Use whichever one makes the most sense to you. There Is also a convenient 
loop_until_bit_is_cLear( ) macro definition available for when you want to wait for a zero Instead of a 
one. 

The actual transmitting of the byte In question Is performed by [be last program statement in the 
function, the assignment of the variable c to [he USARTO data register, UllRO. 

Note that the order of these two operations could be reversed (write, then wall for the operation to 
complete), and the function would still work. However, this is less efficient, time-wise, because the 
USART may a trendy be ready to transmit. You know iliat it won't be ready to transmit after you’re written 
a value to lire data register (because it wilt be busy sending It out, one hit at a time, along with the start, 
stop, and option parity bits), hut you know at least some time Is going to elapse before the calling routine 
calls again. It's better to try to find something useful to do Instead of waiting around (also known as 
blacking} when there's more work to be done. Returning as soon as possible from low-level device 
drivers Is always a good idea. 

Now add the following program statement to the very end of your setupO function: 
usart_putc( ' ! ' } ; // send a test character 

Note the use of the single-quote character to delineate the single -character parameter of the 
function. Upload this sketch to your Arduino, and then open the Serial Monitor window. You should be 
greeted by a single exclamation point. Ibis exclamation point Is brought to you by a sketch that is only 
492 bytes in size on the Arduino lino and 794 bytes for the Arduino Mega 2560. It's only one character, 
but It’s a good start. 
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A String of Characters 

Now you have a function lhat will transmit a single character. What you need Jsa function that will 
transmit as many characters as you want nr need. This may he l r or it may he IGQ, or more. Luckily, 
that’s easy in C. See Listing fi-4. 

Listing €-4. A Function to Transmit a String of Characters 

void usart_puts(ehar *s) { 
while(*s) { 

usart_putc( !t s) i ; 

s++; 

> 

} 

Add this function definition just after the usart_putc() function definition. Looking at this function 
declaration, you see that no return value is expected (void), but the parameter is a little different- 
looking. If you're already familiar with C strings and pointers, feel free to skip over this section. 

The canon leal Unix puts () Function traditionally appends a newline character to the end of the 
siring being printed. You omit that functionality in this simple example, but feel free to add It if you like. 

The (char *s} notation Indicates a pointer to (or address of} a character data type, and not an actual 
char !8 hit) variable at all. A pointer is a variable that contains a memory address that points to 
something. Pointers are their own kind of data type and are especially useful when ynu want to work 
with a piece of data, and the piece right after that one, and the piece right after that one. and so on. 
Arrays of data are a good example. A string of characters is a variable- length array of characters whose 
end is iodicated with a special null value, usually aero. Traditionally, the unprintable ASCII codes, such 
as hell, carriage return, and line feed have short, uppercase abbreviations such as BEL, CR, and LP. The 
very first code, NUL, has a value of aero. Tills can be expressed in C as \0. This is the character that is 
used to Indicate the end of character strings In C. which are sometimes referred to as mil-terminated 
strings. It isn’t the same as the predefined value NULL, which is a pointer Lliat Isn’t pointing to anything, 
usually ((void *)Q). Believe it or not, sometimes that's Just what you want. One example is to use the 
void return value to indicate ihat a function has failed and won't he returning a valid pointer. 

Within the function is awhile( ) loop. The test condition of die while() loop is designated as 
which is read as "the value contained in the variable that Is pointed to by the pointer s" or, more briefly, 
"what s points to." While s points in a value that Is ttue, or more specifically not zero— that is, a 
transmittahle character and not the terminating NUL symbol— the loop continues, sending the value 
pointed to by s to ibe usart_putc(} function. After this, the pointer s Is Incremented using the C 
increment shorthand s++. Because the compiler knows (you told it} that the data typeaf the thing that s 
points to is a char, it knows what size steps to take when incrementing, decrementing, or otherwise 
doing pointer math on s. Even though character strings aren't a fundamental data type that is supported 
by the C programming language, like char, int. long, float, and so on, the standard C library contains 
many functions that work with strings. 

After s Is Incremented, the loop repeats. If the end of the string is encountered, the function 
terminates. 

Replace the usart_putc( 1 ! ' ) test statement at the end of tire setup() function with the following 
and see what happens: 

usart_puts( "Hello* world!"}; 
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If a!] goes we.-]], you should have a 520- byte sketch (for the Arduino Uno; 732 bytes for tlte Arduino 
Mega 256(1] [hat prints "Hello, world!" on the Serial Monitor. All you can print ore either single 
characters or fined strings, hut sometimes that's all you need. Take all that saved program space and d o 
something excellent with ill 


Printing Numbers 

Sometimes single characters or fixed strings are sufficient, but what if you need to take readings and 
report hack numbers? That can be easily done with a very few lines of code. Sec Listing 6-5 fora function 
to print Integers. 

listing 6-5. A Function to Prim integers 
void usart_puti(lang 1) { 

char s 1 2 5 ] l U character buffer to build string In 

itoafi, s* 10); // convert integer to ASCII string* base 10 
usart_puts(s) ; H now print the string on the serial port 

} 

This function uses the power of [he itoa() function from die standard C library. It takes a number 
and converts It to an ASCII siring in tlte radix (base) indicated by the third parameter, which in tills case 
is ten. You could easily make a different version for hexadecimal numbers by changing the radix to l ft. 

These three printing functions, along with tire appropriate initialization steps, should cover a large 
portion of your serial transmitting needs, while not saddling your sketch with excess girth. 

There is also a dtostr() function in the avr-libc standard library that converts a floating-point 
number to an ASCII string. You must specify the width and precision desired In the conversion. Tim 
width is the total size of the resulting string, and the precision Is the number of places to tlte right of tlte 
decimal place. This clever function comes at a cost, adding almost 2KB to the binary sketch size. Also, it's 
interesting to note that the function takes a double (double-precision floating-point number] as a 
parameter, even though tlte math libraries for the AVR treat both tlte single -precision float type arid the 
double as 32-blt values. One doesn't have twice the precision of the othen they’re identical. 

For extra credit, move the U5ART initialization statements to their own function, perhaps called 
usart_init(). You could even pass, the desired baud rate as a parameter to thLs Function, thereby 
emulating the Arduino s 5l.erial.begin() function. Remember to add aealE to usart_inlt[) In your 
setup() function. 


Saving SRAM 

Even more precious than the scarce program memory In the Arduino Is the amount of available SRAM. 
Recall from Chapter 3 that tlte ATmega32fi has a mere 2,(HE5 bytes of SRAM. That's not megabytes or 
gigabytes. The ATmega.2560 has fi ,192 bytes of SRAM — more, but only when compared with tlte 1 1 tile 
one. 

SRAM Is mostly thought of as being used for temporary datastorage, such as variables and the like. 
SRAM is also used for tlte system stack 1 , the place where return addresses are stored during subroutine 
calls and interrupts. The stack Is also used in interrupt handlers to preserve the contents of tlte registers 
needed by the handler UselF, so [hai no registers are harmed in the handling of this interrupt. 
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Like any precious commodity, SRAM is valuable not only because it's scarce, but also because It's 
bard to find. In truth, it's not hard in find but hard to measure. Comparing program space savings Is 
trivial because the Arduino tools publish the resulting sketch size with every compilation. The standard 
Arduino toolset also includes a utility program, avr-size, to tell you how much SRAM is being used, at 
least initially, In a sketch. This helps you measure the fixed for preallocated l amount of SRAM that your 
sketch requires when It first starts. How much SRAM it will ultimately need depends on many other 
factors. Let's cover the easy ones first. 

Measuring SRAM Requirements 

Before you can get all sciemlfical and perform some SRAM measurement experiments, you need to set 
up your laboratory. As mentioned previously- the tools you need have already been provided. All you 
have to do Ls ihe following: 

1. Get to a com m and - 11 ne prom pi . 

2. Find the tool you need. 

3. Find the victim experimental subject. 

4. Perform the experiment. 

5. Repeat. 

If you're comfortable working at the command line, tills process is straightforward. You probably 
already know what's going on here and know several alternate ways of accomplishing the same thing. 
Please feel free to use whatever method works for you. 

On the other hand, if you aren't so comfortable w Lth the command line and all that cryptic typing 
stuff, this may not be the experiment you want to perform today. Feel free to skip over this section for 
now and return when you need to squeeze every last drop of SRAM out of your Arduino. 

Step l varies depending on your operating system of choice. For example, when using Windows?, 
you can navigate to the desired folder using Windows Explorer, bold down the Shift key while right- 
clicking the folder of Interest, and select Open Command Window Mere from the context menu. You 
determine ill e desired folder In step 3. 

Other operating systems, although perfectly cromulent in their own right, have different methods 
available forgetting to a command -line prompt within the correct subdirectory. 

Step 2 can be easy or it can be hard. Once you have the command line window open, simply type 
a v r - s iz e a n d p ress Enter or the equiva lent o n yo u r PC. I f yo u gel L be m essage avr-size; ' a „ ou t ' ; No 
such f ile, then you're in luck! The avr-size utility can be found from your command-line prompt. If 
not, you need to add the proper paib to your PATH environment variable. This varies front one system to 
the next. Repeat until you get the specified message in response to the avr-size command with no 
parameters give it. 

Step3 is a little more complicated. Y’ou need to find one of the Intermediate hies produced by the 
Arduino software during the compilation process. These flies are artfully hidden away from your sight by 
the Arduino software. You can find them, hut It takes some sleuthing on your part. 

Holding down the Shift key while clicking the Arduino Verify toolbar icon produces verbose output 
in the console window. That's the easy way. Note that this only works when clicking the toolbar Icon; It 
doesn’t work when you choose Sketch >■ Verify/Com pile. You can get verbose output during the sketch- 
upload process by using the same trick (hold down the Shift key while clicking the Upload toolbar icon). 

Alternately, you can change the Arduino 's preferences Hxt file and get verbose output each and 
every time you compile. To find the Arduino’s preferences.txt file location, select File >■ Preferences in 
the Arduino software. See Figure 6-1: tlte file location Is given near the bottom of the dialog box. 
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Figure tS-l. The location of the A rdu ino preferences . ti t file is revealed In the File > Preferences dialog 
box. 


In this example, the preferences, txt file is located in the C: \U&ers\DaLe\App[>at.a\.ftoaming\ArdLjino 
folder. Yours will likely be elsewhere. 

When you've discovered ibe secret biding piece of the Ard ulna’s preferences.txt file, edit the file 
with your favorite programmer's editor and add the tine build.verbese=true. Make sure you exit the 
A rdu inn software while editing the preferences.txt file. Note ibat ynu don't have to make this change in 
tiie preferences.txt file if you just hold down the Shift key when compiling. 


The Bare Minimum 

Reopen the Ardulno software, and open the example sketch. Harenlni*um, by choosing File > Examples 
> L. Basics > BareMinimum. As its name Implies, this is the hare -minimum sketch that will compile 
properly using Ardulno. it has skeleton setup( } and loepf ][ functions, and that's all. 

Compile this sketch with verbose output, and pay special attention to the console area at the bottom 
of the Ardulno window. It should resemble Figure 6-2. 
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Plgur* $-2. The verbose output unison causes the Arduina software to reveal the location of the temporary 
folder used to compile the sketch. 

In tins example, the Arduina software created a temporary folder located at 
C: Users \Dale\AppData\ Local ^Temp\build645 &014 193 141 626360. tap. You may want to use the scrollbar 
on the right side of lire console window to scroll up and see what else happened during the compilation 
process, If you're curious. 

This is the temporary folder where all the intermediate files are stored that are created when 
Arduino compiles your sketch, if you shut down the ArduLno software and start it up again, It creates a 
new, different folder to con tain these temporary files. 

The file you're most Interested in at this point is the BarcMlnittLirthcpp.elf file. Notv that you know 
where all the good stuff Is, navigate to this folder and prepare for step A. 

Front your command -line prompt. Issue the following command: 

avr-siie -C --mcu=atmega328p 6areWioimum.cpp.elf 
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Note the capital C in the command-line option: this instructs the avr-size utility to report its 
findings in AVR format. Also, the --meu option has two leading dashes and Informs tlie utility as to the 
storage capacity of the chip's memory hanks, allowing It to calculate what percentage has been used, 
a tmeg.a 3 2 S p has to he spelled out in all-lowercase letters. The avr-size utility won't recognize - - 
®c u - A Tmega 3 28P, for c xa m p le. 

The report should resemble the following: 

AVR Memory Usage 


Device: atmcga328p 

Program: 450 bytes ( 1 . 4 % Full) 

[.text + .data 4 .bootloader) 

Data: & bytes (-0.4S Full) 

[.data r .b&s 4 . nointt) 

Theavr-size utility reports that the HareMlnimu® sketch occupies 450 bytes of program memory 
(confirmed by the binary sketch size report), which constitutes 1.4% of the program memory's capacity. 
It also shows that 0.4% of the precious, precious SRAM (oine bytes) has already been allocated. The 
preallocated memory Is used by the variables Listed in Table 6-1, which were declared In the wiring, c 
file. 


Table £- 1 . Preallocated Variables in the BateHinimum Ardulno Sketch 


Variable Name 

Data Type 

Size in Bytes 

timerO_fract 

unsigned char (II bits) 

l 

t iitier0_ov e r-f Low_c a u nt 

unsigned long (12 bits) 

4 

tirtierOjnilLis 

unsigned long (32 hits) 

4 

Total 


9 


Memory Sections 

The terms .text, .data, and so on, refer to various memory sections within the resultant memory Image. 
Each memory section exists for a different reason.. The . text section is where the executable program 
resides. The .data section Is where Initialized variables are Located, whereas the . bss section Is for 
uninitialized variables. These are the three primary sections within the compiled program. Theavr-gcc 
compiler is quite familiar with them. They have been around, literally- for decades. 

The .noinit section is a. spec Lai exception. Data values placed in this section aren't automatically 
initialized when the sketch begins executing. This Is useful when you want a piece of data to survive a 
device reset, for example. You can place a variable into this section using the GNU Compiler Collection 
(GCC) specific attribute keyword: 

unsigned char reset_count attributc_ [ [section (".noinit") )); 
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Note that the double parentheses are required when using the attribute keyword. You can also 

use this technique to allocate and prepopulate variables in the EEPROM section, using the section name 
.eeprom. This normally creates an additional file with the extension .cep that can he used to program the 
device. The ArduJno's Gptlboot bootloader, however, doesn't currently support writing to the REPROM . 
For now, this must be done with dedicated device programming hardware. The avr-size utility only 
reports the .cepiorn section size If It exists. 

It's still handy for you, as a programmer, to know ahout the .eeprom memory section, because even 
if the cotnenisaf the EE PROM on the chip don't get programmed, It allows the compiler to know about 
the addresses o f the variables within the EEPROM, for use with the ccproni_* functions that are available 
in the avr- Libc library. 


Where Variables Live 

The compiler allocates memory locations for variables based on several factors, usually depending on 
how It thinks they're going to be used. One of the factors that helps the compiler make these decisions Is 
the varl allies' scope, or visibility within the program. 

A variable with global scope is visible from anywhere within the program. These are variables that 
are defined outside of any particular function. A local variable, however, can only be seen from the 
function or block where it's defined. 

The compiler only allocates space within a memory section for either global variables or local 
variables that have the static modifier, meaning that they remain allocated even outside their scope. 
Normal local variables, also known as auiom otic variables, are dynamically allocated on the stack and 
released or deallocated when the function terminates. They don’t need to have a permanent address 
assigned rn them hy the compiler. 

The Initialized variables In the .data section are the global or sialic local variables that have a value 
assigned to them when they ’re declared. Uninitialized variables In the . bss section are cleared to a zero 
value when the sketch first starts. You should not, however, depend on the value of an uninitialized 
variable in your programs. 

Now it's time to perform those experiments. Try running tbeavr-sizc utility on sketches with all 
kinds of different variables, declared In all kinds of different scopes. Mix up the Initialized and 
uninitialized variables, and see which memory section they land in. 


Using the Appropriate Data Type 

The best way tn save SRAM Is to use the appropriate daia type for your variables. Use the smallest data 
type ihat will sufficiently express your data. Table 6.2 lists the standard data types that are available 
within the Arduino programming language. 
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fab Ut HSrAmilabie Dam Types and Their Ranges 


Data Type 

Number 
of Bits 

Number 
of Bytes 

Minimum Value 

Maximum Value 

unsigned char 
byte 

ft 

1 

ft 

255 

signed char 

ft 

1 

-J2ft 

127 

unsigned int 

is 

2 

ft 

65.535 

word 





int 

16 

2 

-32,76a 

32,767 

unsigned long 

32 

4 

0 

4,234,367,236 

long 

32 

4 

-2 ,14?, 4 63 ,64 ft 

2,147,463,647 

unsigned long 
long 

64 

ft 

ft 

1 6,446,744 , 37ft , 733 ,55 1 ,6 1 6 

long long 

64 

ft 

-3 ,22ft ,3 72 ,03 6,854,775, BftO 

3 ,223 , 372 ,636,8 5 4 ,77 5,ft07 

float 

32 

4 

-3.4328235E+38 

3,4028235 E+38 

double 

32 

4 

-3.4028235E+38 

3. 4328235 E +38 


So Hr you're counting from one to ten, you don't need, to declare an int: just lb so a byte. Likewise, if 
you're not using fractions, you most certainly want to be using one of the integer data types and not 
floating-point. 


Strings of Characters* Revisited 

Although theC language makes working with character strings very simple, ii doesn’t {yet} translate well 
to a Harvard architecture such as the AYR. Tire GCC compiler doesn't really understand the Idea of 
separate data spaces for program memory and data memory. It wants to think that all memory is located 
in one big linear array and that there Is One Way to access It. 

This is especially true when handling strings of characters. Let's look at an example. 

Add these two global variable declarations just above the setupf) function in the HareMlnlsum 
sketch: 

char c; 

char msg[] = "This is a message"; 

Now add this assignment statement within the body of the sctup() function: 
c = msgfojj 
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The assignment statement is necessary for [his experiment because any unreferenced variables will 
be optimized out of the program. Compile the program, and take a look at the sizes of the resulting 
memory sections; 

AVR Memory Usage 

Device; atmega328p 

Program; 47 & bytes (l.SS Pull) 

(.text + .data 4 .bootloader) 

Data: 29 bytes ( 1 . 4 S Full} 

[.data 4 .bss 4 . noinit) 

The character string usg was placed in the .data section. This Is appropriate because you may want 
to modify the string at some later point But what if all you want to do Ls print a banner to lire serial port, 
identifying lire program? Most nontrivial programs that have even the most Spartan of user interfaces 
have several read-only character strings that treed to he emitted at some point. 

The present solution is to use the pgmspace functions that are available from theavr-libc library. 
Listing 6-fi contains an example sketch that illustrates the practice of storing Fbted- con tent strings In 
program memory, front tire Arduino web site (wuw. a rdui no. to/ en /Reference/ PR QGMEM), used with 
permission. 

Hating #■’ tf. Example Sketch Illustrating Use of Program Memory for Storing Read -Only Content 


/* 

PROGMEH string demo 

how to store a table of strings in program memory [flash), 
and retrieve thc«. 


Information summarized from; 

http : / /www . non gn u . org / a v r - 1 ibc/ user- mane a 1 / pgmspa c e . html 

Setting up a table (array) of strings in program acmory is slightly complicated, but 
here ls a good template to follow. 


Setting up the strings Is a two-step process. First define the strings. 
*/ 


fl include <avr/pgsspace.h> 
prog_char string_o[ ] PROkHEM 
prog_char strlng_l[j PROCtHEM 
prog_char string_2l ] PRQGHEM 
prog_char strlng_3[] PRDGHEM 
prog_char string_4t] PRQGHEM 
prog_char string_5U PROGMEM 


"String 0"; 
"String i"; 
"String 2"; 
"String 3"; 
"String 4"; 
"String 5" ; 


// "String 0" are strings to store. 
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// Then set up a table to refer to your strings, 

PROGMEH const char *strlng_table[ ] = // change "string_table" name to suit 

{ 

strlng_&* 
strlng_l* 
strJ.ng._2* 
string_3* 
string_4* 
stringy }; 

char buffer [ 30 ]; // make sure this is large enough for the largest string it must hold 

void setups) 

{ 

Serial . begin( 9 Goo) ; 

} 


void loopO 

t 

/* Using the string table in program memory requires the use of special functions 
to retrieve the data. 

The strcpy_P function copies a string from program space to a string in RAM ("buffer"). 
Make sure your receiving string in RAX is large enough to hold whatever 
you are retrieving from program space. */ 


for (int i - 0; i < 6; i*+) 

{ 

strcpy_P(buffer* (char*)pgm_read_word(&(string_table[i] ) )); tf Necessary casts etc. 
Serial . println( buffer ); 
delay ( 500 ); 

} 

} 


Low Power or High Speed? 

You've taken a good first: look at space -saving optimizations. These are easy to measure by comparing 
the before and after sizes of the binary sketch. Measuring execution speed and power consumption Is a 
hit more Involved. 

Power and speed have a close relationship. More speed generally requires more power. Finding the 
optimum balance between tine two is the goal of overall performance optimization. 

Let's explore the limits of both power and speed. First, you find out how fast you can make the 
Arduion run. Then you slow things down a bit. After that, it's time to find out h aw much this 
performance costs in terms of power. Before that, however, you need to equip yourself with the pro per 
tools for the job. 
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Electronic Measurements 

To measure things electrical and electronic, you need a variety of test and measurement equipment. For 
example, you can use a i*olt meter to measure voltage. To measure current, an ammeter is used. These 
tools are good for measuring static or slowly changing levels. For more complex measurements, you use 
more complex tools. 


The Arduino as Test Equipment 

What ic-sl equipment Is available on yoi/r bench? Please don't feet like you must Immediately go out and 
huy thousands of dollars of test gear (unless [hat’s an option and [his was the excuse justification you've 
been waiting for — if so, go nuts!). You maybe surprised by what you can do with what's right in front 
of you. 

For some hascllnc readings on Arduino performance, you can use [he Arduino to measure itself. 
These measurements can be used for relative performance increases but not absalu te read ings, because 
the Arduino must necessarily spend a small amount of time tending to the measurements themselves. 

Open [he Arduino software, and type in the short sketch from Listing &-?. If you're super-lazy, 
rename the stopjtime variable to j and omit the comments. It's ready a very short sketch. 

Listing G- 7. The Arduino Measuring the Performance of the Arduino 
/ / a rdu 1 n o_ perform nee 
void setupO { 

Serial. bcgin(9600); U initialize serial port to 9600 bps 
Ser ia 1. p r inti n(“ Arduino performance test begins now."); 

1 

extern volatile unsigned long timerOjnillls; 
void loopQ { 

unsigned long i = 0; if test value 
unsigned long stop_tlme; //in usiliiseconds 

// calculate stop time ^current time + l second) 
stop_ti»e ■=■ millisQ + 1000 ; 

nhile(timerO_millis < stop_time) i4-+j. if count] 

// report performance resuLts; 

// number of loop iterations in one second 
Serial, print(i); 

Serial, printlnf Loops in one second,"); 
while(l); // and stop here 

} 
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Compile the sketch, and upload it to your Arduino. After the upload is complete, open the Serial 
Monitor window. Make sure the communication rate is set to 9600. Opening the Serial Monitor window 
toggles the Data Terminal Ready (DTR) line on Lhe serial port, which should reset your Arduino and start 
the test over again. If your Arduino Lacks the Auto Reset function, you have to coordinate the pressing of 
the on-board ReseL button after opening the Serial Monitor. In either case, you should be greeted by the 
program self-announcement, "Arduino performance test begins now." (or whatever text, if any, you 
decided to include there), followed one second later by the test-result message. 

Compiled with Arduino (1022 and running on an Arduino Uno, litis performance test reports 636, DOB 
loops In one second. The Arduino Mega 2500 reports 835,901 loops In the same time period. That's a lot 
of loops! 

What do these numbers tell you? These preliminary test results tell you how quickly the Arduino eat) 
do absolutely nothing useful, while measuring the time it takes to do absolutely nothing useful. This Is 
similar to the BogoMIPS metric used to measure the relative speed of CPUs running the Linux kernel 
( see http i li 1 1 dp . axgl H0VJ TO / fSogo.“,i ps). 

As Ralph Tenny once said, "If you can't measure the frequency, measure the period," reminding you 
of the reciprocal nature of period and frequency. Technically, you're not measuring the time it takes for 
eacEa iteration of the empty loop. You're measuring the number of times the loop executes In a given 
time period (the frequency) and using the reciprocal of the frequency to estimate the loop execution 
time. 

Note that you're using the direct t liner t>_«i Ills trick again to keep track of the Ardulno's concept of 
the current time. Because you're not rewriting the timerQ_millis value anywhere in Lhis sketch, ynu 
don’t abandon tire usefulness of the millisO function, as you did previously In the Blink optimization, 
even though it isn't being used elsewhere. This little optimization almost doubles tine number of do- 
nothing loops that can be performed by the Arduino In a given second by eliminating the overhead 
associated with the millisO function call and reading the millisecond count directly. 

Because a slock Arduino Uno uses a l SMHz oscillator (either a quartz crystal or a ceramic resonator, 
depending on the batch buitd date), it can execute up to 16,000,000 inst ructions per second. Because of 
the highly optimized machine code that Is created for the while (} loop that is doing all the counting, the 
loop executes very quickly, li takes 5 cycles to Increment the 32-hit loop counter, 1; 0 cycles to compare 
the tinier0_»illis millisecond counter with the captured step_time variable; and 2 cycles to jump back 
to the beginning of the loop, fora total of 15 cycles. 

if the Atmel AVR was doing nothing else, it should have been able to rust this loop over a million 
times in any given second. However, this sketch depends heavily on the fact thatTlmerO is running and 
generating interrupts on a regular basis; otherwise the loop would never end because there would be no 
incrementing of the millisecond timer. The average cycle time is 1 6,000,000 cycles per second +■ 6 36,61)3 
loops per second, or just over 19 cycles per loop. 

You can now use this cycle count as your baseline reading. Any additional Untie spent in the while() 
toop can be calculated by offsetting Lhe total time by this baseline reading. 

Let's see how long it takes to turn the LED on and off again using the digitalWriteO function. You 
can safely omit the configuration of ii)e LED output pin, because the resulting blink rate will be too high 
to sec with your eyes, anyway. Modify the while Q loop to look more like Listing 6-B. 

List ing V- 9 . Measu ring rht- Perform a a ce of ihedigita Itfri te() Fa ncikm 

wh ile ( t inti o_mil 1 i s < stop_timc) { 
digltalifriteflSj HIGH); If LED on 
digltalKiiteil3, LOW); H LED off 
11 count 1 

} 
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Compiled with Arduinn 0022, the Arduino lino can execute 1 12,653 of these loops in one second, 
whereas the Arduino Mega 2560 can execute only 57,013. of the same loops. The wide variation is 
explained by the larger number of I/O pins that the Arduino Mega 2560 must account for in the 
digitalWriteQ function. 

For the Arduino Uno, these numbers indicate that It takes 16,000,000 cycles per second + 112,653 
Eonps per second, nr just over 142 cycles per loop. You subtract out tire baseline reading of 1 9 cycles, 
leaving 123 cycles per loop. This gives you an average of 66 cycles for each of the two digitalwxlte( } 
functions. This translates Into 4,125 nanoseconds. 

The Arduino Mega 2560, however, takes a leisurely 110 cycles, on average, for each call to the 
digitalWritcQ function, which can also be stated as 6,075 nanoseconds. 

Remember that substitution of the single-instruction hit- manipulation for the digitalWriteQ 
function reduced the time to set or clear a single bit to two cycles or just 125 nanoseconds. Let’s test that 
idea by replacing the dlgitalUriteQ function calls with bitSet() and bitdear () macros, as shown in 
Listing 6-9. 

Listing 6-9. Replacing the di§italHilte( ) Function Calls with Macro: s 

while(tiaerO_millis < stop_time) { 
bltSetlPORTB, 5); // LED on 
b ltd ear{ PORT &, 5); // LED off 
i++; // count! 

} 

For the Arduino lino, the simple substitution Increases the loop count to 690,609 loops In a single 
second. This corresponds with a cycle count per loop of approximately 23, or Just 4 cycles over the 
baseline reading. Because both the ^61 and CBI instructions take exactly two cycles in execute, this Is 
exactly what you expected, li would also appear to confirm the validity of your test. 

The Arduino Mega 2560 also shows a similar boost in performance after the substitution, turning In 
a goodly 662,028 count, remaining right around the average of 23 cycles per loop, which Is only 4 cycles 
above the baseline reading. Remember to set and clear bit 7 of P0HT& on the Arduino Mega 2560, 
although in this example it doesn't really make any difference because the blinking of the LLD is too fast 
to see . 

Applying a final optimization to this loop, let’s substitute the on -again- off- again commands with a 
single bit-toggle operation. See Listing 6-1 &. 

Lis ling. G- 10. Using the Bit-Toggling Capabilities of the A VR to Increase Performance 

while(tl«erO_mlllis < stop_time) { 
bit£et(PIH6 ± 5); // toggle LEO 
i++i U count! 

} 


This loop runs 756,381 times in a second, which corresponds to 21 clock cycles per loop. Once the 
baseline overhead is removed, you tan see that only two cycles were needed to toggle the LHD really 
quickly. And that lines up exactly with your understanding of the S&l Instruction, which needs only two 
cycles to do Lis job. 
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As Fast As Possible 

h’s not especially useful to blink an LED at ibis ridiculously high rate. but It would be nice In lots of other 
applications to send and receive data as fast as possible. Let's determine the highest toggle rate you can 
gei on the I/O pin using software alone. To do this r you must abandon the Ardulno Serial Monitor as 
your test instrument and try something else. 

Take a look at Listing ft- 1 1. It’s a simple program that looks like it ought to be realty ripping along. 

Lining 8" 11, Toggling an I/O Pin as Pastas Passible 
void setup() { 

bitSet(DMG, 5 }; // PS5/D13 is connected to an LED 

} 

void lo&pO -[ 

bitSet [PlSYGj 5}; // toggle LED 

} 

Because the Arduinn is quite busy at the moment, it can no longer help you measure itself. This is 
where you bring in the Big Iron, a piece of test equipment specifically designed to measure high 
frequencies and display waveforms: the oscilloscope. 

An oscilloscope generally displays a graph-tike image that represents a voltage level in the Y- 
di mens Inn over time, which Is represented by the X-d Intension. Figure fi-3 is an example screen capture 
from a relatively low-cost oscilloscope manufactured by Rigol, displaying the output of DIB on an 
Ardulno Unn. 
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Figure 6-3. Digital signal waveform output pom the sketch in Listing 6 - 11 
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In addition to displaying a picture of the waveform for you to see, the oscilloscope a Eso provides 
several other useful measurements, including Frequency, as well as the period of both the high-level and 
tow-level portions of the signal. Additional readings can also be selected on most dighal storage 
oscilloscopes (DSOs).See Figure 6-4. 



Figure it -4, Screen capture from an oscilloscope showing additional measurements 

The scope would appear to be reporting an output frequency of666.7KH2, with an on time ofTSDns 
and an off time of 746ns. Tills would lead you to believe that each pass through the loopf } Function was 
talcing 12 cycles. What’s going on here? 

The answer Is something that's easy to forget when programming the Arduino: the loopO function 
Is being called repeatedly and ad infinitum by the hidden main() function. The apparent slowness of this 
signal is due to the calling overhead of the loop() Function itself. 

Here is a breakdown of what 's happening in this sketch: 

1. main( ) calls loop Q : four cycles on the Arduino U no, five on the Arduino Mega 
2560. 

2. 1 o q p { ) eicec u tes Eh e S61 inst r uct Jo n : two eye les. 

3. 1 o d p {) re tu rns to aa in 0 : fo ur cycle s on the A rd ul no (J no , five on the A rd uino 
.Mega 2560. 

4. main { ) jumps hack to the beginning of itself: two cycles. 

As you can see, the problem Is even worse on tire Arduino Mega 2 560. Due to its larger address 
space, it takes one cycle longer to push and pop the larger addresses l'22-blt vs. 16-blt) to and from the 
slack when performing subroutine calls. The same is true for Interrupt handling. 

To eliminate this slowdown, all you have to do Is wrap the bitSet() macro in a loop of your own 
devising. See Listing G- 12. 
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6" 12. A Faster Loop for Toggling an I/O Pin 

void l&opQ { 
nhilefl) { 

bitSe t{ PlN&j 5); // toggle LED 

> 

} 


This sketch produces a much faster output signal; see Figure 6-5. The entirety of tills sketch, after 
the DO port has been properly configured as an output, consists of two machine-language Instructions' 
bGL and ftJMP. The first instruction toggles the I/O line, and the second Instructions Jumps back to the 
first instruction. 


HiGOL 



Figure tf-S. A much faster output waveform 

Unfortunately, this signal isn’t stable. Watching the oscilloscope display for even a short period of 
time reveals an occasional glitch occurring. Also, the frequency and period readings tend to jump 
around a little. What is causing this? 

You Eefi the millisecond timer running, and it's generating an interrupt about 1,000 times every 
second. During the time that it takes for the interrupt service handier to execute, the I/O line does not 
foggier. You can fix this hy adding the following statement to the setups) function: 

nolntcrruptsO ; // no! 
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This function call, like so many others, is yet another macro. Il turns out to be a single machine- 
language instruction, CLI* which clears the I (for Interrupt] hit in the CPU's status register* S-KEG. TIiJs, in 
turn* globally disables ail interrupts from being acknowledged. Because you don't want or need 
interrupts in this example* this is a good solution to the problem. 


Slowing It Down 

So now you know that you can get the humble Ardulno to output a 2M1 lz signal using software alone. 
That's pretty fasti 1 1 can't do much else at the same time* assuming you want a nJcc, stable signal. Let's 
find out how slow it can go. 

Lowering the operating speed of the Ardulno Is the host way to lower Its power requirements. If 
possible* you can also lower the operating voltage* which also saves power. 

There are two easy ways to change the operating frequency of your Ardulno. The first is to replace 
the quartz crystal or ceramic resonator, choosing a new component with a lower frequency. The other 
option is to change the operating frequency in software* using the clock prcscale register [CLitPfi). Let's 
try the software method first. You can always mangle Improve your Ardulnn's hardware later, if you feel 
the need to do so. 

TheLL&PR register controls the division of the CPU clock according to the values In Table 6-3, 
assuming your Arduino is currently clocked by a 16MHz oscillator. 


TabU 8-3, Clock Prcscale Register Divider Values 


CLKPR Value 

Division Factor 

Resulting Frequency 

cl&ck_.preseale_set(} parameter 

o 

l 

16, 000., 000 

cluck_dlv_i 

i 

2 

6,000,000 

clack_dfv_2 

i 

4 

4,000,000 

clack_dfv_4 

i 

a 

2*000*000 

eluck_div_a 

4 

to 

1 ,000,000 

clack_dlv_i6 

5 

32 

500,000 

elock_di.v_.32 

6 

64 

250,000 

cluck_dlv_64 

7 

12ft 

125,000 

elock_di.v_l28 

e 

256 

62,500 

clock_dlv_25fi 


Changing the CPU's clock affects other peripherals as well* including the analog- to- digital 
Converter (ADO and general-purpose I/O ports. The serial port, however, isn't affected, so you can sllll 
use common communication rates, even when your CPU Is slowed down. 
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There is a special write sequence to update lire CLKPR register. BLt 7. called CLKPCE, must he set to l 
while all the other bits are set to 0 to start the sequence. Then the actual prescaler value must be written 
in tire CLKPli register within four clock cycles. To ensure that this takes place In time, it's wise to disable 
interrupts for the duration of the write sequence. 

Listing 6-13 demonstrates two things. The first is that serial communication still runs at the proper 
rates. The second is that the LED Is blinking very slowly, when It ought to be a high-speed blur. 

Listing 6-13. Stowing ihe CPU Clock 
void setup() { 

Serial. beg in(96O0); 

Serial. println{ "Normal serial co^in Limitation at 9600 bps"); 

pinn&detUj OUTPUT) ; H D13 is connected to an LED 

nolnterruptsf) ; U disable interrupts temporarily 

CLkPfi = 1 <<CLK.PCE; // enable cluck prescaler write sequence 

CLltPfi = 8; if select cluck divisor of 256 

interruptsf) ; // re-enable interrupts 

} 

void loopt) { 

digital¥rite(l 3 s HIGH); // LED is on 
delay(io); U 0.01 second delay 
dlgital¥rite(l 3 P LOW); // LED is off 
delay (ID); if fl.01 second delay 

} 

The Arduino's CPU Is now running at 62.5KHz Instead of the original 1 6MHz. Tire LED Is on for 2.56 
seconds and then off for the same time period. The serial port still worts as you would expect. 

The elock_piescale_set() function, declared in the avr/power.h header file, does the same thing. 


Further Power Reductions 

Two more methods are available to you for reducing [he power requirements of your Ardulnn. The firs l 
is to put [he processor to sleep when it would otherwise just be waiting around for something 10 happen. 
You can save additional power by shutting down unused peripherals. 

The AYR architecture allows for several depths of sleep to occur. You can think of them as ranging 
from lightly napping lo heavy slumber. To access these sleep modes, you can use some functions from 
the avr-llb-c library. Add [he following line to the beginning of your sketch: 

flinelude savr/sleep . h> 

This is a header File that is not normally included automatically by the Arduinn compilation process, 
so you need to explicitly add it when you want to use the sleep functions provided by the avr-libc 
library. 

The lightest form of sleep for the AVR Is known as kilo mode. In thismode r the CPU stops executing 
instructions, which saves a lot of power. ALi the remaining peripherals, however, continue to run at full 
speed, thereby consuming some power. 
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Interrupts are covered In more detail lit Chapter?. For now, you already have a free Interrupt 
configured and running for you: the I'imerU Interrupt used to trigger the millisecond counter. The sketch 
shown in Listing S-14 demonstrates a method for putting the CPU to sleep while waiting for the timer to 
increment. This effectively puts the chip to sleep for about of the lime: a big savings in power. 

tit ting G-X4. PuningtJteCPU io S teep 
Sinclude <avr/sleep.h> 

extern volatile unsigned long tlrnerO_nilLlls ; 
void setupO { 

pinModctU^ OUTPUT); if an LEO is attached to bl3 

1 

void loop [) { 

while (t imer 0_mi 11 is « 1DD0) { 

set_sleep_mode< SL££Pj'WieE_l[>LE); // select "lightly napping" 
sleep jnodef ); // go to sleep 

> 

timerCMftiLlis = 0; // reset millisecond counter 
bitSet[PLJJ6j S); // toggle LED 

1 


BONUS: DIGITAL SIGNAL PROBE 


A crude digital signal probe for use with your Anduino can be built using only a short piece of 22-gauge 
wire. You can use smaller- diameter wire, but it tends to fall out of the expansion header sockets. Larger 
diameter wire or repurposed paper clips arent recommended because they tend to deform the internal 
spring structure of the header pins, rend Bring them potentially unreliable in the future. 

To build a probe, follow these steps: 

1 . Take a 6" piece of 22-gauge solid, insulated wire and strip about a quarter (1/4) of 
an inch of insulation from both ends. If you want to get fancy, you can solder 
header pins to a similar length of stranded wire of any small gauge, but only a 
simple wire of some soil is reeded for this experiment. 

2. Compile and upload the example Blink sketch to your Arduinoi 

* File > Examples > 1 .Basics > Blink 

* Sketch > Verify / Compile 

* File > Upload to I/O Board 

3. Verify that the LED is indeed blinking properly. 

4 . Using the code editor change all references to pin 13 to some other pin number, 
such as 2. The code should now look like this: 
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void setup() { 

// initialize the digital pin as an output. 

// Pin 11 has an LED connected on most Arduino hoards: 
pinnode(2 t OUTPUT); 

} 


void loopO -[ 
digitalnritetlj HIGH); 
delay (1000); 
digit alHiitefl, LOW); 
delay ( 1000 ); 

} 


// set the LED un 
U wait for a second 
U set the LED off 
fi wait for a second 


5. 5av B this sketch with a d iff erent nam e ; don 't overwrite your exa m pi e sketches! 

6. Compile and upload the sketch to your Arduino. Verify that the LED is no longer 
blinking. 

7. Install one end of the wire in the expansion header pin socket marked 1 3. 

8. Install the other end of the wire in the expansion header pin socket marked 2. 


9. Verify that the LED is mow blinking. 


Why does this work? Remember that you changed all the references to pin 13 to pin 2 (or some other 
convenient pin of your choosing). Because D13 was not configured as an output in the setup( ) function, 
it remains in its default state as an input. As an input, it doesn't mind at all if another output is connected 
to it. The LED and its associated current-limiting resistor remain electrically attached to pin 13, but pin 13 
no longer drives it. Any signal you now connect to D13 will show you whether it's high (LED on) or low 
(LED off). 

Try probing the other pins in the expansion headers. Because the modified Blink example sketch didn’t 
specifically configure any Dther pins as outputs, they normally show up as low (the LED remains unlit). Pay 
special attention to the relative brightness of the LED as you probe the 5V line and the 3.3V line. Which one 
is brighter? Why? 

More extra credit questions: Why does probing the RESET line cause the Arduino to reset? Why is the RX 
line always high, even when nothing is being received on the serial port? 

You can always use the programmable LED as a digital signal probe as long as pin D1 3 is left as an input. 

Avoid probing the Vin pin if your Arduino is powered by an external power supply of greater than 6V. The 
LED won't mind, but D1 3 certainly will. 


Summary 

The Arduino software takes advantage of the many optimizations provided by the avr-gtc compiler and 
the finely- crafted avr-libc library. The Arduino -sup piled libraries., on the other hand, could use a lithe 
help- 
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Speedy size, or power; pick all three. There's plenty of opportunity to squeeze more performance 
from your Arduino. You Just need 10 know where to start looking. This chapter gives you Lhai start. 

You can apply many other optimizations to your Arduino sketches. This chapter Is just a hrlef 
example of so me of them, to the next chapter, you look at ways to obtain more performance from your 
Arduino by learning about some of the powerful peripherals that are waiting to do some work for you. 
Synchronizing your hardware and your software allows you to achieve very impressive performance 
improvements. Using the hardware-signaling system of Interrupts lets your software be automatically 
notified when something Interesting happens. 
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Hardware Pius Software 



Software commands hardware. Can hardware- command software? Yes! h can and it should, from time to 
time. When the two cooperate, it's more like a dance and less like a military exercise. Let’s look at some 
ways to make your software more aware of tire available hardware, and what benefits you can derive 
from this mo re- cooperative relationship. 

The first step is to learn more about the peripheral hardware that is already built in to your Arduino 
and how to use it in your applications. Next you move on to using interrupts more effectively, which can 
make your Arduino look like it can do more titan one thing at a time. 

Available Peripherals 

You've already used several of the Arduhto’s built-in peripherals in the example sketches. The serial port 
lets you communicate with the host PC as well as other serial devices. The digital ins and outs Eet you 
i urn things like LEDs on and off, as well as tell If buttons have been clicked. The pulse- width -modulation 
(PUWI l outputs are an excellent way to simulate an analog output using a diglial interface, which is 
perfect for dimming lights and controlling motor speeds. Driving the PIVM outputs arc tire lower-level 
timer/ counter peripherals, which can be used, as their name implies, for both timing and counting 
purposes. 

The Atm el AVR also lias a couple of true analog peripherals, including the analog-to -digital 
converter (ADC) and an analog comparator (AC], These inputs take a varying voltage, generally ranging 
between ground (OV} and V, , [BV] , and convert Jr into ones and zeros. 

Let’s take a look ai some of these available de vices- wl thin -the -device and see what happens when 
you ilJp them over to fully automatic. 


Serial Port(s) 

The Ardui no's serial port gets a lot of use. It’s the preferred mechanism for uploading new sketches from 
the development software to the chip Itself. You can use it to debug programs and report readings, It 
works straight out of the box, using the supplied Serial library, and it uses only two device pins to do so. 

The Arduino Lino has a single hardware serial port, USART, whereas the Arduino .Mega has 
four of them. Both flavors of I/O Boards connect their first USART to a serlal-LJSB Interface. Ii r s also 
possible, In a limited fashion, to use any pair of the other digital I/O pins as a serial port using [he 
taftSerial library. The advantages of using a real hardware IJSART certainly outweigh any software 
simulation, assuming you have enough USA Ill's to go around. 
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A Small Replacement for the Serial Library 

3 11 Chapter 6, you replaced the Ardui no -supplied Serial library with a Tew simple functions. Yon saved a 
lot of program memory, but at what cost? No facility was provided to redefine serial input. The 
transmission of data was quite wasteful of CPU bandwidth, as the processor waited, patiently, for every 
single character to shuffle slowly out the serial port, doing no usefui work Ln the Interim. No attempt was 
made to provide fraflrfsAtiftngwith the serial port on Lite other end of the line, and no contingency plan 
was in place to handle any errors that might occur. 

With ail of these shortcomings, the estercl.se was still worthwhile, because it did Implement a very 
simple method for sending a limited amount of data via the serial port while saving quite a hit of 
precious program memory. Keep this technique in reserve for when you need to send a small amount of 
data hut don't need all the bells and whistles provided by the Serial library. 

is the Serial library always a better alternative in nontrivial applications? Sometimes, but not 
always. There are still timing and reliability Issues with this software, which should one day be sorted 
out. In the meantime, you can use the existing US APT hardware, taking advantage of its talents and 
capabilities, which free up the CPU to do other tasks. 


What the USART Does 

The main Job of each of the USARTs on hoard the AVR is to serialize and deserialize a stream of data bits. 
This allows a multihit piece of data, such as an eight-hit byte, to be transmitted or received using a single 
wire. Otherwise, eight data Kites pi us some sort of timing signal, or strobe line, would be needed to send 
or receive a single byte of information. That sort of arrangement is usually called a parallel interface. 

The USART also handles, in hardware, the generation of the proper timing signals and the 
appropriate framing, error- checking, and synchronization hits that allow It to comply with 
asynchronous serial communication standards. Beyond these duties, the USART hardware In the AVR 
also provides a small amount of buffering, which permits a byte of data to be prepared for either 
transmission or reception while another one is actually being transmitted or received. 

The very basic task of shifting bits in and oui at the proper rate, with the right framing, can be 
accomplished with software, as illustrated by the abilities of the SoftSeriaL library. On the smaller AVR 
devices that lack any hardware USART, this is the only option, short of adding a dedicated USART 
peripheral to the circuit. Letting the hardware USART do its Job frees the CPU to get on with other 
business. 


Talking to the USART 

Instead of dealing with the individual bit timings and ali the other low-level details for serial 
communication, you did manage to use the built-in USART hardware to do all that work for you. Once 
the proper device configuration was performed (a total of four program statements), all you had to do in 
order to transmit a byte of information over the serial port was to write to a register, a la UDRO = c;, and 
you were done. The USART considers it polite to wait for that byte to finish transmitting before 
trail smitting another byte, and it even provides a status bit Ln one of its control registers to tell you when 
that moment occurs. 

What you did in your first- generation USART code was sit there and watch the USARTQ Data 
Register Empty [UDR Eo J bh In the UtSkOA register until it changed. This Is n w ngte of time an opportunity 
for excellence, in addition to the UURLO status hit, the USART also provides an interrupt to let the CPU 
know when the UJRLO hit is set, {called the Data Register Empty interrupt), indicating that (here is now 
room In the IJSART's output buffer mechanism for anew, transnilttable byte. 
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Bear in mint! that another, similar Interrupt is available from the USART: the Transmit Complete 
interrupt. From the sound of Its name, it would seem tike this Ls the one you would want to use. There 
has been some confusion over [his choice in the past. The Transmit Complete Interrupt occurs when [be 
serial transmission is totally finished: that Is. after the las[ part of the la&[ l>i t is sent out the serial port. 
The Data Register Empty Interrupt occurs before the Transmit Complete interrupt, due to the internal 
buffer in the USART hardware. You should use [he Data Register Empty Interrupt to tell you when to 
reload the data register, if needed, because you can send out another hyte before the previous byte has 
completely shifted out the serial port. 

You can use the Transmit Complete interrupt in applications where some action needs to take place 
to commemorate the end of the serial transmission: for example, when special transmitter hardware 
needs to he powered down. Because you're just wanting to save some tune at the moment, you use the 
interrupt that happens first and saves you the most time: the Data Register Empty Interrupt. 

The USART hardware can also generate an interrupt Ln response to the complete reception of a byte 
from the serial port. Tills Interrupt Is called the Receive Complete Interrupt. See Listing 7- 1 for an 
example sketch that toggles the LED every time a new character arrives via the serial port. 

List ing, 7-1. USART Receive Complete Interrupt Example Sketch 

void us a rt_ in it (unsigned long rate} { 
tlCSftOA = ocmeo I 0CCU2X0 I OCC.HPCHO] 

UCSftOS = 1«RXCIE0 | OicUClla I OtcUDHIEfl I i«RXENO | 0<<TX£N0 | 0«(JCS202 | 0«TXflfl0; 
IJCSROC = 0<<UMb£L01 I Q<<UMSE LOO | Ck<UPHOi | G<sUPMOO | OsdJSGSG | i^UCSZOl | 1«UCSZ00 | 
OcclJCPOLO; 

UBftftO = ( L CPLP / ib 7 rate - i); 

} 

void setupO { 

bitSet(DCR&j 5}; // Dl3 (PBs) Is connected to an LED 
Lisart_init(9600) ; // configure UbAkT 

} 

void loopQ { 

// nothing happens here 

} 

ISA (USAR I_RJt_vect ) { 
bitSettPI*JSj 5}; // toggle LEI? 

unsigned char c = UDftOj // read incoming byte to clear interrupt flag 

} 


There area few important items to discuss in this sketch. First, the USART initialization code has 
been collected into its very own subroutine, called usart_InitQ- The desired communication rate 
(sometimes called Lho baud rate) Is passed as its only parameter, a la the Ardu Luo’s Serial, begin() 
library function. 

You can save a few more bytes if you know ahead of time what baud rate you want to use, Instead of 
passing it as a parameter to usart_init(). You can use the fiAUD ftAT t_DlV!SOR macro definition from the 
previous sketch in Chapter S ("Writing to Configuration Registers" section), instead. This is because the 
compiler sees the constant value indicated and docs the math Itself, reducing the equation to a single 
number. Otherwise, the Arduino lias to calcufate the hand rate on the fly. which involves two division 

operations and results in the final sketch containing the udivmodsi4 library function, which is artfully 

compact but still takes up some space. 
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Notice the second line of the usart_initO function: 

Ut^ROft = l«RXaEO I OccTXmo I 0<<PDftIEQ I kc&XENO I OkHtlXEPJO I 0<<UCS202 | Ck^TXHSO; 

The KXCIEO bit fllSARTG Receive Complete Interrupt Enable) and the kxfcrio bit (U SARTO Receiver 
Enable) are the only hits that are set to i Jn this assignment statement. This could just as easily have 
been accomplished with two much shorter lines of code: 

bitSetfUCSROti, RJtCIEo) ; H enable receive interrupt 
bitSetfDC^QB, RXE&ld); H enable receiver 

This would have resulted in a slightly larger sketch, however. Because the USART control registers 
aren't in the addressable range of the S&I and CBI machine -language Instructions, the compiler can't use 
them to directly manipulate the bits In theUCSRoB register. It’s forced to perform a read An odifv/ write 
operation on the UCSROB register twice. This results In a binary sketch size of 618 bytes, compared with 
the original, more compact sketch that contained fitlft bytes. 

The TXttoQ bLt isn't set to l because you're not using the USART transmitter at all in this sketch. The 
other bits remain the same from the previous example sketches found in Chapter 5. The setup [) 
function is fairly predictable, configuring the DIB pin lPR5 on the Arduino Uno) as an output so you can 
see the LED later, and then catling the usart_inlt ( ) function to get the USART rolling. 

Of special Interest Is the loopO function, which Is suspiciously empty. All the fun stuff happens in 
the interrupt service routine HSR), which is defined just after the loopO function. LS&() Looks like a 
function hut is really a macro defined in the avr/interrupt ,h header file. The parameter passed to the 
I S R macro is the predefined signal name of the interrupt handler, which in tills case Is U&Aft1_fiX_veet. 
Signals are a holdover from long, long ago; the term signal described what you now know as Interrupts. 


Note You don't get to name your interrupt handlers. You must use the signal names supplied by the avr-libc 
library. See Table 7-1 and Table 1-2 in the section “Pin -Change Interrupts." And yes, they all end in _vect ; which 
is short tor vector. 


The Interrupt handler works mostly \\i%t Like any other function, except that it never takes 
parameters and it never returns a value. You cover a few other ISR-speclflc details shortly. 

In the ISR{U£AftT_RX_vect) handler, you seethe shortcut LED toggle method: 

bitSetfPINlU 5); // toggle the LED' 

So every time this interrupt handler executes, you should be able to seethe LED change slate. 

Also In the interrupt handler is a dummy read of the I) SARTO data register, SJDftO. This read is 
required to reset the "receive complete" interrupt fag. Normally an application shows some sort of 
interest in the incoming data stream, but this example sketch Just wants to demonstrate how an 
interrupt handler is written, and the received value is discarded. 

Compile and upload this sketch to your Arduino Uno. Verify that the LED toggles for every character 
that is sent from the Serial Monitor window. Remember that you must click the Send button or press the 
Enter key to actually send anything. Sending two characters at a time toggles the LED and then quickly 
toggles it back again, so you should only see a very short blink. 

You can do something more Intelligent In the interrupt service routine If you like. Try the code in 
Listing 7-2, replacing the previous interrupt handler. 
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Lining 7"M. Alternate USART Receive Complete interrupt ha tidier 

ISR(U£MI_IH_vect) { 

unsigned char c = ODfttU if lead' incoming byte to clear interrupt flag 

i He ==’!') i 

bitSet{ POftTfl, 5); // turn on LED 
} else I-f(c == "O' 5 { 
bit£lear(J>DfiTB, 5 ); if turn off LED 

> 

} 

That’s a!] there is to writing an Interrupt handler. The hard part is to pick the right interrupt to use, 
enable it, and. then find the correct signal name for it from the available documentation. See Table 7-7 
and Table 7-8 in the section "Interrupt Reference.” Note that the current avr- 11 be documentation as 
supplied by the Ardulno software is chock-full of errors and omissions, especially in the signal-names 
section. This is mostly because the documentation was automatically generated from the source code 
comments, which suffer from repeated "improvements," usually of the copy- and- paste variety. 

This sketch Is specific to the Ardulno Uno, not only because the LTD bit is hardwired to PBS (recall 
that the LED Is attached to PB7 on the Ardulno Mega 2560) but also because the ATmega2560 has four 
IfSARTs (USARTD-i] f and the handler names are different: 

ISR(USAK i OKXvect) 

ISR(USAftTl_ltt_veet) 

mtUSART2_RX_vect) 

IH(U£ARl3_llX_vect) 


Caution The compiler doesn’t check for proper handler names. At this point it can only lock to see whether 
the handler name ends in _veet. Using USART_FtX_vect (for the ATmega328) instead of USARTO_RK_vect (for the 
ATmega2560}will produce no compile-time errors, only runtime errors. 


ISRQ Options 

The avr-Ifbc library provides several options to pass along to [he Interrupt service vectors, depending 
on how you want them to behave. 

The first parameter to the ISR function Ls the signal name [hat is to be handled. It bears repeating 
that you do not get to name your own signals. You must use otic of the predefined signal names from the 
avr-libc library, 

As discussed in Chapter 3, interrupts must be enabled in two places to ever fire. The first Is specific 
in ihe hardware that Ls generating the Interrupt, such as the USART peripheral. The second is the global 
interrupt enable bit (I) contained in the processor's status register {SftEGl. If the I bit isn't set, then no 
interrupts are recognized, acknowledged, or acted upon by the processor. The Arduino software 
provides two simple macros for enabling and disabling the global Interrupt enable Sot: 

interrupts!; ) 1 
nolnterrupt&O ; 

These two macro definitions resolve into the single machine-language Instructions Set I Bit in SREC 
(EEl) and Clear ! Bit in SREC iCLIj, respectively. 
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When enabled, and the right conditions prevail, an Interrupt can toe generated. This launches a 
series of actions on the part of the processor. First, the global interrupt enable bit I is cleared. This 
prevents any further Interrupts from being handled until either 

* Tire interrupt handler routine returns or 

* The interrupt handler routines explicitly reenables the I bit 

The address of the current program Instruction is saved on the stack. The processor then vector* 
(jumps! to the specific location in the interrupt vector table that is reserved for that Interrupt. The 
interrupt vector table usually contains ]utnp UMP) Instructions that point the processor to the 
appropriate Interrupt handler routine. 

The Interrupt vector executes, and when It's complete, issues the special Return from Interrupt 
fRETI) instruction. This Instruction recalls the program counter's previous value by popping it from the 
stack and reenables the global Interrupt enabte bit. Program execution resumes from the point where it 
was interrupted. 

Although the processor automatically saves the program counter's contents, this isn't true of either 
the processor's Sit EC or the contents of any of the general-purpose registers, RI-R31. All but the most 
trivial of Interrupt service routines need to save the processor's state before performing any calculations; 
otherwise the Interrupted program running in the foreground Is In fora nasty surprise. 

The compiler knows how to properly save the processor's state, and the code to do so Is 
automatically Included both before and after the code written by the application programmer In the 
interrupt service handler. 


Nested Interrupts 

To allow the use of nested interrupts — that Is, an interrupt handler that allows other events to interrupt 
it — you can add the IiR_hH>t5LQ£K modifier to the ISR handler; 

I^R(USAfiT_RX_vect , I5R_N0BLGCK) 

Using this modifier reenables global interrupts earlier In the execution of the handler than 
specifically executing the interrupts{); macro call would. 


Empty interrupts 

Some Interrupt flags are cleared when the Interrupt service routine executes, unlike the USART Receive 
Complete interrupt, which required the data register to be read. In these and similar cases, no other 
action may be required to be performed by the interrupt handler, and the interrupted program can 
resume as quickly as possible. This is often the ease when the processor is put to sleep and one of the 
peripherals needs to wake it up. To do this and generate the minimum amount of code, you can use the 
EM R TV_1 fo! I E R RUf^T ( ) macro Instead of the ISR() macro; 

EMPTVJN! EEfiUPT [TlMEIlO_0VF_vect) ; 

This macro then creates a handler that does nothing except return to the interrupted program using 
the RET! instruction. No function body is required when using this alternative form. 
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Bare-Naked Interrupts 

When you need the moat control over the code go tug into your interrupt handler routines, you eon use 
the I S K_NAK £ D modifier, which generates a function body Lacking both the standard pm Log and epilog for 
saving and restoring the processor state. You even have to explicitly Include the PtETI Instruction within 
such a function, because the compiler isn't going to put a/tyihingiti there for you. 

If your handler only needs to update a flag or perform some other miniscule task that doesn't affect 
either the SkEG or the general-purpose registers, you can use ibis option: 

KB(TIMIRO_QW_vect f ISRJUHED) { 
bitSetfPlJJGj 5>; 

reti(); // return from interrupt 

} 

Tim retif) function La another macro that Inserts the correct machine-language code for the Return 
from Interrupt instruction, it’s defined in the avr/ interrupt . h header file. You must include this macro 
as the Last statement in your Interrupt handler Lfyou use the I SR_NAKED modifier. 


Undefined Interrupt Behavior 

If an interrupt occurs for which no handler lias been written, the default action taken hy the compiler is 
to tell the processor to jump hack to the beginning of its program, effectively restarting the chip. It does 
this by filling Hie interrupt vector table with had interrupt vectors, unless the application program writer 
specifies a proper handler for a particular interrupt. 

You can change this default behavior by defining your own default function, using the BflDISR_vect 
signal name: 

ISR(6ADlSff_vect) ... 

Undefined interrupts generally Indicate software bugs. Restarting the sketch is a hit drastic, 
however. You can more elegantly handle it using the 0ADISfi_vect option. 


General-Purpose Digital Inputs and Outputs 

You've been playing with the digital input and output (I VO} pins In almost every example sketch. You’ve 
learned how to configure them as either inputs or outputs, either using the pinnodeH function or 
specifically setting the direction hits In the data direction registers (UDk*: . You've mostly been working 
with individual 370 lines using either the Arduino-supplled digitalwritef) function or the bitSetQ and 
hitClear[} macros. It*s also possible to read the values presen ton the pins by either us Lng the 
digitalRcadO function or directly interrogating the PIN* registers. 

Another fun trick is to enable and disable the built-in pull up resistors on each of the Input plus, 
using the otherwise-unused data register, which Is normally used when the pins are set up to be outputs. 
Along the same line, the output state of any pin can be toggled by writing to the Input Pins address; this 
is very useful when you don’t want to disturb any of the neighboring 370 pins. 

You can also read and write up to eight hits at a time by talking to the 3 /G ports' data register and 
Input Pins address. This can be much faster and more compact than updating nr checking each pin 
individually. 
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Pin-Change Interrupts 

Besides till this general functionality, all of [he I/O pins on the Arduino Uno, and up to 2 4 of the pins on 
the Arduino Mega 2StiO r can ho configured as pin change interrupts. This permits any of these pins to be 
set up to notify the CPU if anything changes on their inputs, without forcing the CPU to constantly check 
in to see what's happening. 

Pin-change interrupts are grouped into three banks of up to eight individual lines apiece. Each hank 
has an interrupt associated with It. L'hese banks generally correspond with the general-purpose I/O 
ports. See Tahle 7-1 aod Table 7-2. 

Tab (e 7-1. Pin - Ch ti nge U j terrii pts fat A Tm ega32& 


General-Purpose HQ Port 

Pin Name 

Pin-Change interrupt Bank 

Pin-Change Interrupt Name 

Port B 

PBD 

Bank 0 

PC INTO 

PBl 

PCI N'T i 

PB2 

PCINT2 

PB3 

PCI NTS 

PB4 

PCINT4 

PBS 

PC [NTS 

PBS 

PCINTfi 

PB7 

PCI NTT 

PortC 

PCO 

Bank 1 

PCI NTS 

PCI 

PCINTfl 

PC2 

PCI N T 10 

PCS 

PCINTil 

PC4 

PCI NT 12 

PCS 

PCI NT IS 

PCS 

PCI NT) 4 
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General-Purpose I/O Port 

Pin Name 

Pin-Change Interrupt Bank 

Pin-Change Interrupt Name 


PDO 


PCINT16 


PD 1 


PC1NT17 


PD2 


PCI N'T IE! 

Pori D 

PD3 

Bank 2 

PCINTLU 

PD4 

PCINT2Q 


PD5 


PCINT21 


PDti 


PCINT22 


PD7 


PCINT23 


Note: PC 7 {PC INTI 5) doesn't exist on the ATrnega32&. 
Table 7-2. Pin-Change Interrupts for ihe ATmega2S6Q 


General-Purpose I/O Port 

Pin Name 

Pin-Change Interrupt Bank 

Pin-Change Interrupt Name 


PBO 


PCINTO 


PB1 


PCI NT 1 


PB2 


PCINT2 

Port B 

PB3 

Bank 0 

PCI NTS 

PB4 

PCINT4 


PBS 


PCI NTS 


PBE> 


PCINT6 


PB7 


PCI NTT 
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Continued 


General- Purpose I/O Port 

Pin Name 

Pin-Change Interrupt Bank 

Pin-Change Interrupt Name 

Port E 

PED 


FONTS 


Pin 


PCINT9 


PJi 


PCI NT 10 


PJ2 

Bank 1 

PONT 11 

Port | 

4*1 

“i 

CL 

PCI NT 12 


PJ4 


PONT 13 


P/5 


PCI NT 14 


PJ6 


PONT 15 


PKG 


PCI NT 16 


PK1 


PONT 17 


PK2 


PCI NT IS 

Port K 

PK3 

Bank 2 

PONT19 

PK4 

PCINT2Q 


PK5 


PCINT21 


PKH 


PCJNT22 


PK7 


PC1NT23 


To respond to a pin-change interrupt, you amiat do three tilings: 

1 . Ena Me the a p p rop rla te p Lji - c h an ge i n i or rup t ban k using the PC ICR reg Lstc r. 

2. Enable the specific pins to ho usod using the PCMSKO-2 registers. 

3. Write an in te rru pt h audio r ro at I lie. 
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Single Pin Interrupt Example 

Let's cry using a single pin-change interrupt to see how it works. You take advantage of the fact that the 
pin-change Interrupts don't care if the pin that's Involved is an input or an output. This way* you can 
invoke an interrupt through software by changing the state of an output pin, without Slaving to attach 
any new hardware to the Arduino. 

Let's go hack to your faithful friend. Blink. Select File.*- Examples > LBasics > Blink from the menu. 
Add the following lines to the end of the setup [ ) function: 

Serial, begin(9&0D)i 

bitSetfPCICRj, PClEo); U enable pin change interrupt bank 0 
bitSetfPCHSkdj FEINTS); // enable pin change interrupt on PCINT&/D.13 

You leave the loop() function alone. It continues to turn on the LED, wait a second, turn off the 
LED, wait another second, and then repeat. That's what you tike about Biink. 

Add the following interrupt handler for pin -change interrupt bankth 

ISfi(pnmo vect) { 
if(digitalkeadCll) == HIGH) { 

Serial. println("L£D is on"); 

} else { 

Serial. println( "LED is off"); 

} 

1 


Compile and upload this sketch. Open the Serial Monitor window, and observe what happens. 

You should get a message about once a second* alternating between "LED is on" and "LED is off." 
The interrupt handier gets invoked every time there is a change in the state of the PCJNT5 pin* which you 
also know as D 13 nr PBS. You don't get to -specify what kind of change. So when the loop( ) function calls 
the digi?alnrite( ) function to either turn on or turn off the LED* as Song as the new value is different 
from the present value* a pin-change interrupt is detected, and the interrupt service routine is called. 

In the interrupt service routine* the digitalRcad() function is called to determine the present state 
of the pin. If it’s HIGH, the LED is on, and a suitable status message Ls sent. Otherwise, the LED is most 
likely off* and that status is likewise reported. 

This example is quite simplified because only one pin holds your interest. You knew that only one 
pin had been authorised to generate an Interrupt* so it wasn't bard to figure out what happened. 

You can use any of the DO pi ns on the ATinega32S as pin-change triggers. Each pin-change 
interrupt bank has its own interrupt handler, it's up to the individual Interrupt handler to determine 
which pin changed* triggering the interrupt request. This can be discovered by reading the status of the 
port pins* using the Input Pins address fPINx) for the applicable port. 

The ATmega2S0Q also has three banks of pin-change interrupts. The same registers are used to 
enable Lhe individual pins and banks, although banks 1 and 2 are mapped to different ports. 


Timers and Counters 

The ATmega328 has three unique timer /counter peripherals* cleverly named Timer /Counter 0, 

Timer /Counter I* and Timer /Counter 2. Each timer /counter peripheral is slightly different from t he- 
athers. Let's look at Timer/Counter 0 first and learn what makes It so special. Once you understand what 
makes (Elis timer tick, then you can go on to the other two timer/counters and concentrate on how they 
differ from Timer/ Counter 0. 
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Timer/Counter Q 

At the core of Timer/Counter A is an eight-bit counter. Tills means it can count from 0 to 253, at which 
point it starts over again at 0. St can also count from 0 in 255, then hack down front 255 to 0, over and 
over again. This is the basic thing that li does: its reason for existence. 

Several variations cm this basic theme can he made with Timers Counter Ik You can specify a 
different maximum number instead of 255. It can he either a counter or a timer, In its role as a timer, Ji 
can be clocked l>v the CPU oscillator or through a prescaler with predefined divisors. These divisors can 
he I, fl, 256, or 1,024. Asa counter, it can be driven from an external input pin. 

Tlmer/CounterOhas two pulse-width-modulation (PWM) channels associated with it. |PW\1 is 
explained In more detail In the section “Pulse-Width- Modulation (PWM) Outputs.") 


Timer/Counter 1 

The heart of Timer/Counter 1 is a 16-bit counter. This allows It to count from l) to as much as 65,535. 
Like Timer /'Counter 0, it can either always be counting up or It can count up, then down, then up, then 
down. 

Timer/Counter 1 also has an input capture unit, which lets it put a timestamp on an incoming 
signal. Two PWM channels are available for use with Timer/Counter 1 on the Arduino Uno, and three 
PWM channels on the Arduino Mega 256f). 


Timer/Counter 2 

Timer/Counter 2 is remarkably similar to Timer/Counter 0. It's an eight-bit counter with two associated 
PWM channels, having both timer and counter facilities as well as the ability to generate several 
interrupts. 

What makes Timer/Counter 2 special is its ability to be driven asynchronously from the CPU clock, 
via a low-frequency 32Kllz waich crystal attached to theTOSCl and TOSC2 pins. On the ATmega32B. 
these pins serve double duty with the primary XTAL1 and XTAL2 pins, normally connected to the I6MIIz 
quart crystal or ceramic oscillator. This prevents most Arduino 1J no-compatible circuits from 
implementing this feature. 

On the ATmega256Cl, however, the TOSCl aod TQSC2 pins are only shared with the PC 4 and PG2 
general-purpose I/O tines. The AT mega 2 560 has dedicated XTAL1 and XTAL2 pins, so no conflict is 
present. Timer/Counter 2 can be clocked using a low-power (as well as relatively low -frequency) watch 
crystal. This allows the implementation of a real-time clock (hat can continue to run when the processor 
is put to sleep. 


ATmega2560 

The ATmega2560 has all the same timer/counter peripherals as the ATmega32fl, and then some. 

Timer/Counter 1 on the ATmega2560 Is also a 16-bit c outlier, just Like on the ATmega320. It adds an 
additional PWM channel, fora total of three PWM channels on Timer/Counter l alone. 

If that weren't enough, the ATmega2560 sports three more 16-blt timer/ counter peripherals, which 
arc all clones of Timer/Counter L They're aptly named Timer/Counter 3, Timer/Counter A, and 
Timer/Counter 5. 
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Timer Interrupts 

You can perform some simple experiments with the timer/ counter Interrupts to get an idea of how they 
operate. The Arduino software has already configured all the timer/ counter peripherals for use w r Lth the 
analogWritcO function, as well as time-keeping duties for Timer/ Counter 0. You use Timer/Counter 1 
for this experiment, fully aware that you then lose the use of analog fPWM] outputs 9 and 10 on the 
Arduino lino. Sec Listing 7-3. 

titling, 7-J. A Simple Timer Interrupt 
void setups) { 

MtSetiDORGj 5); // PBS/Dij has an LED attached 
TCCftiA = 0; 

TtCftlB = 1«CS12; 

bitSet[TlMSKl, fOIEl); // enable over-Flo* interrupt 

} 

void loop Q -{ 
ff nothing happens here 

} 

lSK(TIMERi_QVF_vect) { 
bitSet[PIW6j 5); // toggle LED 

1 

Compile and upload this sketch. Behold! You have yet another blinking LiiD. Let's see exactly what's 
going on here. 

Th e set u p ( ) functlo n sta rts off w 1th the fam i Lia t p innod e ( ) i'unctl o n replace me n i , u itSot ( M) R6 t 5], 
just to save a little program space. Then you see some manipulation of the timer control registers, which 
is where all the magic happens. 

The second line of the setup{) function clears a II the hits in the TCCRlA register. This register controls 
the assignment of the PWM output pins and also contains two of the four bits used to select the rioter 
mode. Because the Arduino software had already programmed this register to provide for PWM outputs 
that you aren't using, you clear out all the hits at once hv writing a zero to tite register. 

The next timer configuration statement writes a single l to the CSli hit location, of the Tttfilfi 
register, which has the side effect of alsn writing zeros tn all the other hit locations. The other two mode- 
select hits were in this register, but you wanted to set them to zeros, anyway. TheCSt2 hit is one of three 
hits (CSlO,CSlL r and CSil) that select the prescaler value for the system clock to drive the counter In a 
timer mode. There are eight possible combinations (see Table 7-3), and you want the one that provides a 
divlde-by-256 prescaler of the system oscillator. Setting only ihetSli hit makes this selection for you. 
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Tabt* 7~3, Timer Clock Select Bits par TimeriCounter l 


C512 

CS11 

C51Q 

Description 

0 

0 

0 

No clock 

o 

0 

l 

Divide by 1 

0 

1 

0 

Divide by 6 

o 

1 

1 

Divide by 64 

i 

6 

0 

Divide by 256 

i 

0 

1 

Divide by 1,023 

i 

1 

0 

Use the failing edge of external Input Tl 

i 

1 

1 

Use the rising edge of external Input T 1 


Timer/Co u nter 0 has a similar set of predefined clock prescalers that can foe selected. The only 
differences are that the hit names areCSQ2, CSOL, and CSMkand that the last two options select Input pin 
TO instead of Tl. Timer /Counter 2 Is different, it doesn't support an external input In the same way that 
Timer/ Counter 0-1 can. See Table 7-5, later In the chapter. 

Because the system clock on a standard Arduino Is 16M3lx. the clock signal provided to the timer 
circuit is now 16,006,000-?- 256 = 62,5001 la, or 62.5KIIz. This value was selected with some care, and It 
nearly approximates the maximum value that the 16-blt counter in Timer/Counter 1 can hold, which Is 
65,535. In other words, when driven at this clock speed, the counter overflows in just over L second. This 
generates an overflow interrupt, the interrupt service routine executes, and the LED is toggled. 

The final timer configuration statement In the setup ( ) function specifically enables the overflow 
interrupt for this timer. Timer Overflow Interrupt Enable l (101 El). Because the Arduino software lias 
already enabled the global interrupt hit, things should start happening In just about one second, 
assuming your interrupt service routine Is In place. 

The Interrupt handler couldn't he simpler: 

l&R{TlH£fil_OVF_vcct) { 

bitSet(PlNfc, 5); // toggle LED 

} 

This example illustrates the normal mode of the timer, which is only one of many possible modes 
that are available using the timer/ counter peripherals. For example, if you wanted an interrupt to occur 
exactly every second, you could use one of the two Clear Timer on Compare Match (CTQ modes, in this 
mode, you configure a prescaler and select the counter /timer mode in a manner similar to the previous 
example, hut then you program the desired match value used to trigger a reset of the counter, instead of 
letting it rollover on its own. See Listing 7-3. 
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Lifting 7-4. Generating a Timer Interrupt Every Second 
void setups) { 

bitStttDOKGj s>; // LED on fBS/DlJ 
TCCElA o 0] 

TCCfilS = l<<W(kHl3 I L<<«CH12 I 1«CS12 | i«£SlQ; 

ICftl = 15625; 

bitSet{IIMSKl, KIEL); // enable capture event Interrupt 

} 

void loopQ { 

// nothing happens hero 

} 

I6E(TIMfcRl_tAPT_vect) { 
bilSettPINGj 5}; // toggle LED 

} 

This mode uses the Input Capture Register (ICRl) to hold the compare value. The value is calculated 
by dividing the system clock by the requested presealer, which determines the number of clock cycles to 
count before starting over, which fires the Input capture event interrupt. In this case, the largest 
prescaler, 1,024, is used to divide Lhe system clock, resulting In a clock signal of 1 5.62-5K II z driving the 
timer. 


Pulse- Width -Modulation (PWM) Outputs 

Each of the timer/counter peripherals has at least two PWM channels associated with it. The ArduLno 
software automatically configures all of the available timers for hardware PWM dutyai the beginning of 
every sketch. 

Using the Ardul no-supplied analoghriteQ function, the hardware PWM channels can he easily 
programmed with any value between (1 (completely off) and 265 (completely on). Anything in between 
produces a variable duty-cycle pulse stream at approximately 4HQII2. 

The Arduino software treats all the PWM channels the same, limiting them to eight-bit resolution 
and hardwiring them to a relatively slow frequency. It's not bard to reprogram any of the available PWM 
channels and reconfigure them to your liking. The only trick Is choosing among the many operational 
modes and setting the parameters accordingly. 

Listing 7-5 is a short experiment you can try, which illustrates (be simplicity of the Ardulno's 
analogWritcQ function and the use of PWM. 

Listing 7-5. Fading lhe LED Using PWM 

void setupQ { 

} 

void loopQ { 

static byte pws =0; 
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analogWrite(ll , pwni); N set the PWM duty cycle 
delay(lfl); U a very short delay 
pwm++; // increase the PkM duty cycle 

} 


Note iIlci c you don't have to explicitly set the direction bit for the output pin when using the 
Arduino' s analog* rite () function. It takes care of this for you. If you don't use die artalogWrlte( ) 
function, and you set up the PWM outputs yourself, you need to remember to configure the proper pEn 
as an output, either using thepinMudcO function or setting tire bits in DDkx appropriately. 

Compile and upload tins sketch to either an Arduino Uno or an Ardulno Mega 5560. Nothing 
happens. To make something happen, all you have to is connect Dll to D13 using a short length of wire 
or a small-value resistor [see “Digital Signal Probe" in the Chapter 6). 

On the Ardulno Mega 2560, you can use D 1 3 instead of D 1 1 and lire sketch works without the help 
of the exira wire. This Is because the Arduino .Mega 2561) has 14 PWM outputs, which happen to include 
D 13 — the one dial is already connected to the LLiD. 

Using the Ardulno Uno h however, you have only six PWM outputs, and Dl3 is nor one of them. 
That's OK — you can still connect one of the proper PWM outputs (D 1 1 is the closest, so ihai's what you 
use] to D 13 and Lighi up the LED, as long as D13 Itself isn't programmed to he an output. 

Without the wire, using analogWriteO on a non-PWM pin produces l for values 126 and above and 
Q for values less than 126. 


PWM Tricks 

You can eliminate the Jumper wire in the previous exmei.se and replace it with a hit of software trickery, 
based on what you previously learned about using pin-change interrupts. See Listing 7-6. 

Listing 7-tt. Transferring ifie PWM Output to n Differ^m Pin Using Pin-Change Interrupts 

void setups) -[ 

bitSet (DORIS, 5); U LED pin 

bit.Set(PCICft, PCLLfl); U enable pin change interrupts on bank 0 
bitSet (PtMSftO, PClNTj); // enable PCIN73 (P63) pin change interrupt 

} 

byte pum = 0; 
void l&opO { 

analeg'write(ll , pwm ) ; // set the PWM duty cycle 
delay(lb); // a very short delay 
pwrn++s // increase the PnM duty cycle 

1 
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I5R(PC3MlO_vect ) { 
if (bit Read (PI MB, j)) { 

bit 5c t( POSTS,, 5); H LED on 
} else { 

bitClearfPDGIB, N LED off 

> 

} 

Nothing changes in [be Loopf ) function. The value of Lite pm variable is used to write an analog 
value to the PWM output pin r using the analagWiitef ) function. Then Lite pm variable is incremented. 
When it gets to its maxim uni value (255 for a byte, which is the same thing as an unsigned char), it rolts 
over m Its minimum value, which is 0. 

The setup £ ) function now contains the initialization coda to enable PCINT3, which corresponds 
with the digital pin 1 1 used by the analogwrftef ) function. Because PCINT3 is contained in the first hank 
of pin-change interrupts, you write an Interrupt handler for the PClMfO_vect signal. 

The Interrupt handler checks the state of the port pin, using the bitRead[} macro. Notice that no 
explicit comparison is done in this conditional statement. The bitRead() macro returns either 1 orO, 
depending on the state of the bit being examined, in theC programming Language, conditional 
statements are evaluated as either true (nonzero) or false [zero). When the output pin is a logical i, the 
bitftead() macro returns a value of true, so the LCD is turned on. When it returns a false value — that is, 
zero, indicating the pin is in a logical low state — the LED is turned off. The conditional statement could 
he more explicitly written as 

if (bitRead(PlN&, 3) « l) ... 

This is yet another example of the possible compactness possible in the C language. Those guys 
were lazy efficient. Compactness and clarity aren't always the same thing, however. It's certainly 
possible to write such dense code that you. yourself, can t comprehend it. This is even more prevalent in 
other programming Languages, such as Forth, which is considered by many to be a write-only language. 
Good commenting discipline bcipst 

Remove the Juniper wire from your Arduino Uno. compile and upload the sketch, and observe what 
happens. If all goes well, the LED should be ramping up In brightness over the period of approximately 
2.5ti seconds and then starting over again. 


More PWM Trickery 

The PWM hardware can generate its own interrupts. In the previous example sketch, the PWM signal 
was present on two pins at once. This is a neat trick and can come in handy when you need to duplicate 
a relatively slow signal on multiple pins, for example, using the hardware USART to transmit on several 
different lines at once. 

Lei's use the PWM interrupt for overflow to increment the PWM duty cycle for you. You continue to 
use one of the Arduino lino's PWM -capable pins, D 1 1. You saw from Ihe previous sketch that this pin is 
also referred to as FB3 (Port E5, hit 3j. To get even closer to the bare metal, you need to know the 
timer/ counter with which this PWM output Is associated. Table 7-4 lists the timer/counters, their PWM 
outputs, and both the AVR names and Arduino names for the Arduino Uno. 
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fab U 7 -4, Timer/Counter PWM Phis on the Arduino Uno 


TimehCounter 

PWM Output 

AVR Name 

Arduino Pin 

Tinier/Counter 0 

DC DA 

PD6 

t> 

DCOB 

PD5 

5 

Ti me r/ Counter 1 

OClA 

PB1 

9 

DC IB 

PB2 

Ml 

Timer/Counter 2 

DC 2 A 

PBS 

11 

DC2B 

PD3 

3 


Working backward through Table 7-4, you sec that Arduino PWM pin 11 Is connected to 
Timer /'Counter 2’s 0C2A output. Each of the thner/counters on the ATmega328 has two PWM channels 
associated with It. referred to as A and B. When configured for PWM usage, the Internal counter is 
continuously compared with the values stored Jit the two Output Compare Registers, OCRxAand OCPaB. 
Several options exist for what to do when the values line up properly. 

For your second PWM experiment, you configure Tinier/Counter 2 for normal counter mode and 
enable both the Compare Match A interrupt and Overflow interrupt. When the counter overflows, tfie 
count starts over at zero. At this point, you want to turn on the LED. When the compare match event 
takes place, you want to turn off the LED. To do so, you define two interrupt service routines. See 
Listing 7-7. 


Littitig ?-7. Reassign ing PWM Outputs to Any Output Pins, Using Interrupts 

void setup() -[ 
bitSet(MHE6, S); // LED pin 
rC.Cft2 A. = d; 11 normal mode 
rCCft^S = 5; it super slow CK/12S 

rinSK2 = i<<0CIE2A | 1<<!0IE2; // enable «atch and overflow interrupts 

} 

byte pwm = 0; 
void leapt) { 

analog* rite(ll ( pwm); // set PwH duty cycle 
delay (io); ii a short delay 
pwm++; // Increase PWM duty cycle 

} 

ISB ( TI HE R 2_0Vf_ve et ) { 

if(pwm) bitSet(f ! ORTfS J 5); U LED on j maybe 

} 
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IS»(TIMIR2_ttMPA_v«:t) { 

if (prim < bitClear (PORTS y 5); // LED offj maybe 

1 

The setup( ) function looks pretty familiar, configuring [he LED output pin and [he timer /coon ter 
peripheral. Timer/ Counter 2 lias a slightly different set of available clock prescalers- see Table 7-5. You 
also enable two distinct interrupts associated with Tuner/ Counter 2, the Match Compare A and 
Overflow interrupts, by setting the appropriate bits E0C.IE2Aaod T0IE2) in the Tlmer/Counier 2 Interrupt 
Mask Register, TIHSK2. 

Ttthie 7-5, Timer Clock Select bits for TimerfCoutiter 2 


C522 

CS21 

C5Z0 

Description 

0 

ft 

0 

N o clock 

ft 

0 

1 

Divide by 1 

0 

i 

0 

Divide by Ei 

ft 

i 

1 

Divide by 32 

i 

0 

0 

Divide by 64 

i 

a 

I 

Divide by 12fl 

i 

i 

0 

Divide by 256 

i 

i 

1 

Divide by 1,024 


The loopf) function slowly adjusts the PWM duty cycle upward by continuously writing to [he PWM 
hardware using the analogWrite() function. You could save 53d bytes of program memory by not using 
the analogWrite( ) function and writing directly to the compare register, 0C12A. 

There is a bit of finesse going on in the Interrupt service routines. You could have simply turned on 
the LED in the overflow Interrupt (where the counter has Just restarted from zero? and turned it off again 
at the compare match Interrupt. This mostly works. It fails at the endpoints, 0 and 255. This Is because 
the simplistic approach to PWM (turn on at zero, turn off at compare match) falls to consider that you 
may not want to turn on the output I'for example, when the output is zero) or that you may not ever want 
to turn off the output (for example, when the output is full-scale). 

In the overflow interrupt handler, the zero output scenario is tested by the shortened conditional 
if ( pwm), which returns true as long as the value of p*ui isn’t zero; otherwise it returns false and the rest 
of the statement isn’t executed. The compare match Interrupt, on the other hand, only clears the output 
if the PWM value Ls less than full scale (255). 

Let’s try one more variation of the PWM reassignment experiment. This time, you move all the 
functionality that is presently In the LoopO function — that Is, the ramping up of the PWM output value — 
into the overflow Interrupt handler. Why? Because the overflow interrupt handler is being invoked on a 
regular basis, every time the counter overflows from 255 back to 0. This happens on a fixed, periodic 
basis. 
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Either delete or com in ent-ou tall the code in the loop[) function. Now update the overflow handler 
as follows: 

lift ( T 1ME R 2_0Vf_ ve cf ) { 
if(pwm) bitSet(PORTB, 5}; // HD on^ maybe 

OCRIA = pwmj 
jtwm++j 

} 


Compile and upload the sketch. You should seethe same old thing, just a little faster. Why faster? 
Let's calculate the update frequency. 

The system clock remains at lfiMEIz. The prescaler you selected for Timer /Counter 2 was divided hy 
12:33 hy writing a 5 to the control register, fCCfiZB. This means the counter Is being clocked at 
16,0O0,00OHz-i- 128 - 125KIIz. After every 256 clocks, the counter overflows. This occurs at roughly 
-iftfil Iz. This is when the overflow interrupt occurs. In the interrupt handler, the PWM value fpwm) Is 
incremented by one, which correspondingly adjusts the PWM duty cycle when It’s written to the Output 
Compare Register A for Tim erV Counter 2,i)CR2A. Because this value, too, overflows when It gels to 255 (or 
after every 256 Interrupts, if you want to look at It tike that), this results in an apparent blinking 
frequency of-4B8Hz + 256 = - 1.9.1 1 z, or about twice a second. ThLs can be adjusted in large steps by 
changing the presealer value of the timer. 

What's interesting about this approach is that the loopQ function is now doing absolutely nothing. 
All the action Is happening behind the scenes In the interrupt handlers. 


Analog Inputs 

Bo Hi tite Arduinn Uno and the Ardulno Mega 2560 have a single ADC peripheral on board. Each ADC 
unit has an Input multiplexer with several Inputs. The ATmega32B has 6 analog inputs, and the 
ATmega2560 lias 16 analog inputs. Only six of the eight available analog inputs are available on the 
plastic DIE version oftbe device. The surface- mount version lias all eight Inputs available, but only six of 
them are connected to anything on the Ardulno Uno. Several Ardulno clones provide extra headers for 
these two extra ADC inputs. 

The Inputs to the ADC multiplexer share pins with the general-purpose digital inputs and outputs. 
This means If you don't want or need to use the analog inputs in your application, you're free to use 
those pins as regular digital 3 VO. 

If, on the other hand, you’re going to use any of the pins In analog mode, you should consider 
disabling any unused digital inputs by setting the individual bits | ADC 00— ADC 5 D) In the Digital Input 
Disable Register!] !D1L>R0>. This reduces the amount of power that would have been used by these 
unused digital inputs. 

The ATmega25fiQ has an additional Digital Input Disable Register to accommodate its larger array of 
analog inputs, but curiously it's called DIDfi.2. The missing DID-Ri Is found on the earlier ATmega 16, which 
used a completely different bit-mapping in the register, so the name was most likely changed to prevent 
confusion. 

The ADC peripheral measures analog voltages by a method known assoc ces s i ft? a pprox im aiion. You 
may already lie familiar with this process, but as the children's game Guess the Number. After each 
guess at the secret number, the guesser Is informed if they’re too high or too low until the right number 
is eventually guessed. The AVR's ADC peripheral methodically guesses at each of the ten bits In the 
resulting conversion by creating its own internal, adjustable voltage and comparing It in the sampled 
voltage from lire analog Input pin. This process is repeated ten times and eventually produces the analog 
conversion result, which is a number In the range of 6-1,02:1. 
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The ADC peripheral runs on Its own clock, which In most cases Ik much slower than the processor 
clock. The optimum clock frequency range* between 5 OKI Iz and 2DQKI I?.. A prescaler Is provided to 
divide the processor clock to an appropriate frequency. 

When the conversion process has begun, it takes 13 of these scaled-down ADC clocks to complete 
the conversion. The exception is the very first conversion performed after the ADC peripheral Is enabled, 
which takes 25 ADC clock cycles to complete. 

When the conversion is complete, the result is stored In a register and the peripheral's status flags 
are updated. The ADC can generate an interrupt once a conversion finishes. 

If the ADC function isn’t required in your application, consider disabling the peripheral by resetting 
the ADC Enable (AO EN) bit In the ADCSR A control register. Although this bit Is off by default after power-on 
or a chip reset, the Arduino software turns it on at the beginning of every sketch. 


Arduino lino as Thermometer 

The ATmega32fi on the Arduino lino also has an additional, internal ADC channel that is connected to a 
temperature sensor in the chip. This feature Isn’t implemented on the ATmega25fif) chip. 

You need to tweak this sketch to get an accurate reading on your Arduino lino. Each temperature 
sensor Is relatively linear in response, but the overall accuracy Is rated at ±5L) <, C. See Listing ?-fi. 

Listing 7-0. Arduino (fnarts Thermometer 

void setup( 5 { 

Serial. begln(96oo); 

Serial. println[ 'Arduino Uno as Thermometer" ) ; 

ADNUfc = l«ftEFSl I tccREFSo | lscMUKi; // l.lV reference, ADC channel "8" 

ADCSRA = ic<ADEN | KcADSE | 0x07; // enable ADC, start conversion, i2& KHz clock 

} 

Sdcfine OFFSET 343 
void loopQ { 

Serial. print (ADC - OFFSET); 

Serial, printing"); 

bit Set [ADCSRA, AD SC); // start next conversion 
delay (2 50); It wait 

} 


Coin pile and upload the sketch. Open the Serial Monitor, and see what it says. The first few readings 
may welt be way off, but soon it will settle down and start reporting the temperature of the Internal 
sensor. 

The setup[ ) function first initializes the serial port and then configures the ADC to measure the 
special ADC channel assigned to the internal temperature sensor. It specifies that the 1.1V internal 
voltage reference is to be used I n stead of the A. , voltage, which is normally 5.0V. Tins gives a hotter 
match to the output of the temperature sensor, resulting in a more accurate conversion. 

The loop!) function prints the conversion result, adjusted by the OFFSET value, followed, by the unit 
of measure (C). The code continues on to start a new conversion by setting the Start Conversion hit 
CADSC} in the ADCSRA control register. A short delay is performed, and the loopO function repeats. 

You need to adjust the OFFSET value to calibrate your Arduino Uno. Bear in mind that the 
AT mega lift chip will he as much as 3 } C warmer titan the ambient air. 
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Arduino as Voltmeter 

In Chapter 6 you hullt a digital signal probe, using just an Arduino and a short Jumper wire. This tool is 
very useful for determining if a digital signal 1s high or low. it's not especially helpful if the signal is 
somewhere in between. For measuring voltage levels, you need a voltmeter. 

You can build a limited- range voltmeter using the same Arduino and jumper wire and a different 
sketch. It would he nice if you could attach a variable resistor called a potentiometer ia the circuit or use 
something like the Maker Shield (see Figure i-(i in Chapter 1}, which already has a potentiometer 
installed. If not, you can still explore some of the varying voltages on the Arduino itself. 


Caution ff you're powering your Arduino via the USB cable, there are no dangerous voltage levels to worry 
about, ff, or the other hand, you're powering your Arduino via the external power connector, take care xwf to 
connect the Vin connector directly to the pins of the AT me pa chip on your Arduino. 


Listing 7-9 shows a simple example sketch that repeatedly reads analog pin AO and then prims out 
the average value over the serial port. 

Listing 7-9. Simple Analog Voltmeter 

void setupO { 

Serial . bcgln[96oo) ; 

Serial . pr intin ["Arduino Voltmeter" ) ; 

} 

Sdefine SAMPLES 2500 
void lo&pQ { 

unsigned long voltage - 0; 
unsigned int 1; 

for(i = 0 ; i < SAMPLES; i++) { 

voltage +■= onologftead(D); ti accumulate samples 

> 

Serial. print((( (voltage * 5,0) / 1024) t SAMPLES), 4); 

Serial, pi intirO"); 

} 

Compile and upload this sketch. Then open the Serial Monitor window to see what's going on. You 
should see the program banner and then a series of voltage measurements. 

Connect All to the bV pin on the power expansion header. The readings may vary due to the 
acceptable tolerances on your Arduino 's power supply, so don't he alarmed if you see 4.9785V on the 5V 
Une. 

Now li-y the connector and see whether you're getting something In the neighborhood. Finally, 
try connecting your voltage probe to one of the G>ID connections and make sure the sketch is reporting 
something quite close to O.OOOOV. 
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The setup[ )■ function initializes the serial port and. prints a short announcement as in the 
application's primary in tent. The loopQ function lakes a large number of samples, specified by Lite 
constant defined as SAMPLES, adding nil the samples together in a big pile. After all the samples have been 
gathered together, Lhc actual voltage is calculated based on the number of samples and adjusted by the 
analog reference voltage (AftEF) and the resolution of the ADC. The resulting voltage 1s reported to foLar 
decimal places on the serial pori, and the loopQ function repeats. 

The ADC produces a reading that has a resolution of ten bits. The lowest value, being a signal at or 
near ground 1 0 V I . should be zero. The largest reading, a signal just at or above the AR1IF voltage, should 
return a value of 1,023. These numbers are always Integers, having no Fractional pan or digits to the right 
of the decimal point. Lacb bit In the result represents AREF/l r 024. On the Arduino Uno, AREF 1s 5.0V, so 
each bit represents ap proximo rely 4. BflmV, or0.0048ftV. If your Arduino Js running on a different 
voltage— for example, the Arduino Pro or Arduino Mini at 3.3V— you need to adjust the sketch 
accordingly. 

To improve the accuracy of the readings, you can use the technique of oversampling. You take more 
than one reading and calculate the average [technically, the arithmetic mean) of all Lite readings by 
dividing the sum of all the readings by the number of readings taken. 

The number of samples specified it] die example sketch was chosen to produce a summary voltage 
report about 4 times every second (specifically, It turns out to be closer to 3.496 reports per second). This 
is fast enough to be useful and slow enough to he fairly accurate. 

This reporting frequency wasn’t chosen at random, however. The ADC 1s clocked by a signal derived 
from the system clock. The optim um ADC frequency Is stated In the AVft datasheet as SOKLIz to 2QCKHz. 
The Arduino software selects a clock prescaler of 128, which produces an ADC clock of 125 KHz, well 
within the optimal range. 

Each ADC conversion, after the first calibration conversion has been completed, takes exactly 13 
ADC clocks. This results In a maximum sampling rate of just over 9,6 IS conversions per second, 
assuming a system clock of 16MHz. This doesn't take Into account the time required to read the 
conversion from the ADC hardware, add it to the running total, or keep track of the loop count. 

Theoretically, by using the ADC's con vers ton-complete Interrupt, you could accumulate 2,500 
samples and report the resulting voltage as many as 3.646 times per second. That's not a giant Increase 
in reporting frequency — only about 10%. However, It may be a good idea in certain applications to have 
the ADC conversions happening in the background while a higher-level application executes in the 
foreground. Let's see what It takes to get that going; see Listing 7-10. 


listing 7 - 10. Arduino as Automatic Voltmeter 

Sdefine SAMPLES 2500 

void setups) { 

Serial.begln(9bLio); 

Serial.println[~Ardufno Automatic Voltmeter"); 

ADMUk = icckEFSO; H select ADCO (Ad), AR £ F -AVCC (5.0V) 

ADCSfiA o lccADEN | L^ADSC | lesADATE j 1«ADIE | 1«ADPS2 j l-<sA[}P5l | ls<ADPS0; 
AIXSREl = 0; // free running mode 

birSet ( DIDftO, AfrCOD); N disable digital Input en ADCo 

1 

void loop() { 

N nothing happens here 

} 
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ISR(AD£_v«ct) { 

static unsigned int 1 = 0; // sample counter 

static unsigned Long voltage = Q; // voltage reading accustuLator 

voltage + = ADC. ; // accumulate voltage readings 
i++; N also count samples taken 

ADMUfc = lcc REF SO; U re- select AKO (AG), A k t F = AVCC (S.GV) 
if ( I >= SAMPLES } { 

Serial. print{ ({(voltage * 5.0) / iQ24) / SAMPLES), 4); // report 
Serial. printing "V" ) ; // label units of measure 
voltage - 0; // reset voltage readings 
i = 0; // reset sample count 

> 

} 


Corn pile and unload this sketch, and then open the Serial Monitor window in seethe results, it 
should beltave a ioi like the previous sketch. Take some voltage readings to make sure things are stiil in 
order. 

The main difference in this automatic version of the voltmeter sketch starts in the setupO function. 
The ADC peripheral is configured to generate an interrupt when Jt completes a conversion, by setting 
tbeADIE hit in the AlXSRA register in l. in addition, the free- running mode of the ADC is enabled through 
the combination of the ADC Auto Trigger Enable hit iADATE), which is also in the ADCSRA register, and the 
lower bits of' theADCSRB register, which you set to all zeros. This operational mode instructs the ADC to 
automatically start a new conversion after the previous conversion completes. Other conversion Lriggcrs 
are available as well, including interrupts from the AC. the external interrupt request 0, and select 
timer/ counter interrupts. The free- running mode ensures the fastest conversion turnover, triggering a 
new conversion immediately after the previous conversion is finished. 

Because you're using oversampling to augment the limited resolution of the ADC, it’s possible to 
speed up the ADC clock by choosing a smaller prescale divisor without losing too much accuracy. 
Selecting the divlde-by-64 divisor effectively doubles the sample rate while reducing the effective 
resolution by one bit. 

Shortened conversion cycles means less available time to handle the end -of-eon version interrupt. 
This leads to another important observation about the example sketch. The optimum Interrupt handler 
gets in quickly, does its Job, and exits promptly. Performing a lot of floating-point math, formatting 
reports, and sending data via the relatively slow serial port aren't the kinds of things you want in a 
production-ready interrupt handler. Ideally, the interrupt handler aggregates the data and sets a hag, 
indicating to the foreground process that a report is ready 


External Interrupts 

The Arduioo software has a little support for using interrupts In your sketches. It uses interrupts 
internally for timing functions. It makes provisions for enabling and disabling interrupts globally, using 
the interrupts{) and noIntcrruptsO macro definitions, which resolve to the SEI andCLl machine- 
language instructions, respectively. 
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The only other support present hi the Arduino software for interrupts is the attauhlnterruptO and 
de tat hint err upt ( ) functions. These fu net Jons allow you to connect a function of your own devising to 
the avaiiabte ex tern a l in terrupts of ib e AVR core. These interrupts are tied directly to the core, and their 
inputs share pins with lire other general-purpose I/O lines in both the ATmega,T28 and the ATmega256G. 
See Table 7-fi |n/c stands for not connected). 


table 7-$ r External Interrupts 


External Interrupt 

Arduino Uno 

Arduino Mega 2560 

Port 

Pin 

Port 

Pin 

INTU 

PD2 

2 

PDO 

21 

INTI 

PD3 

3 

PD1 

20 

INT2 



PI>2 

IS 

I NTT 



PI>3 

18 

INT4 



PE4 

2 

INT5 



PES 

3 

INTS 



PEG 

n/c 

INT7 



PET 

Jl/C 


The ATmega326 has two external interrupts, INTO and iNTl. They share pins with PD2 and POT, 
respectively. These I/O pins can he configured as Inputs [with or without enabling the huilt-in pullup 
resistors) or as outputs. 

The ATmega25G0 has eight external Interrupts, INT0-INT7. They share pins with I/O lines from 
Ports D and E. Only six of the available external interrupts, INTG-5, are connected to anything on the 
Arduino Mega 2oti0 I/O Board. 

External Interrupts work in a manner similar to the pin-change interrupts discussed earlier. External 
interrupts, although more scarce, arc* more flexible in their configurations. Each of the external 
interrupts can he Individually enabled or disabled, just like the pin -change interrupts. However, each 
external Interrupt has its own Interrupt vector. You can configure the external Interrupts to detect pin 
changes, like the pin -change Interrupts, but also program them to only respond to rising edges, failing 
edges, or low levels. This allows a bit more discrimination In determining what external signal should 
generate an interrupt. 

Let’s take a look at this signal-filtering capability of the external interrupts, using the Ardulno- 
suppiled functions- see Listing 7- 11. Just add the hold statements to the Blink example sketch. 
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Listing 7-11. Exploring External Interrupt Trigger Configurations 
void setupQ { 

// initialize the digital pin as an output. 

// Pin 11 has an LED connected on most Ardutno hoards: 
pinMode{iJj OuTPsJT^ i 

Stria 1 . begin [ & 6 DO ) j 

attach Interrupt^, tattle, CHANGE) ; // jumper Dz to DlJ 

} 

void loopO { 
digital¥rite[l3 f HIGH); 
delay [ idoo ) ; 
digitalwiitefll, LOW); 
delay ( 1000); 

} 

void tattle( void) ( 

Soria 1* px lntln( "I ' m tell ing T " ) ; 

} 

In the setup 0 function, you additionally initialize [lue serial port and altacb the- function tattlef) to 
external interrupt O, INTEL to trigger on any CHANGE in the incoming signal. Notice that lire second 
parameter of the attachlnterrupt( ) function doesn't contain any sort of special punctuation, such as 
parentheses. In C, tit is doesn't invoke or call the function, but serves as a reference to its address in the 
program space. The Arduino-s up plied attachEnterrupt( ) function uses this address as a destination to 
jump to when one of the predefined external interrupt vectors is executed. 

The tattleQ function is called when the external interrupt Fires. If you attach a juniper wire 
between DLl (the LED output) and D2 (the external interrupt input], you should see some output from 
the serial port, both in the Serial Monitor window (the preferred method] and also on the TX LED on the 
Ai duinn I/O Board. This should coincide with the alternating of the LED. 


// set the LED on 
fi wait fox a second 
fi set the LED off 
!i wait fox a second 


Note The tattleO function in the previous exercise is rrafan interrupt handier per se. It’s simply a function, 
like any ottier function. The Arduino software has already provided the appropriate interrupt handlers for all the 
external interrupts— i NT o_vcct and so on — and these functions in turn call the user-written handler function 
when enabled by the attachlntexruptQ function. 


The other possible conditions acceptable to the external interrupts are RISING. FALLING, and LEW. Try 
them now, in place of the CHANGE parameter of the attachinterruptO function. KITING should only 
produce a tattle as the LLD begins to illuminate, hut not when it's extinguished. FALLING should produce 
the opposite effect. 

When you try LDW, however, something seems to go wrong. The LED quits blinking, and a steady 
stream of tattling ensues. What happened? 

The LOU setting is somewhat special When [he input signal is low, the interrupt fires and continues 
to fire as long as the input stays low. In this case, [he external interrupt is detected, and execution 
proceeds to your tittle tattleQ function. The tattleQ function sends out a message via the serial port 
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and then returns. The low condition persists, however, because your foreground program doesn't get a 
chance to change the state of the LCD before the external interrupt again is Invoked — and it never will. 

T ry not to code yourself into tills particular corner, if you can help It. Don’t interrupt on a low-level 
signal that won’t eventually change of Its own volition, or none of your other programs will ever get a 
chance to run again. The problem is compounded because the external interrupts have the highest 
priority In the Interrupt structure of the AYR, so even another, active Interrupt handler won t be able to 
execute while this condition persists. 

It fc possible, on the other hand, to disable the external interrupt in the interrupt handler routine, 
thus knocking the computer chip nut of its rut. Adda detachlnterrupt(O) ; statement to the end of the 
tat tie 0 function. This solves the problem of the endlessly relnterruptlng interrupt, but it also disables 
the intended function of the sketch. 


Interrupt Reference 

Table 7-7 and Table 7-fl provide lists of all the possible Interrupt sources for both the Ardutno lino and 
ibe Arduino Mega 234>r>. 


Tubt* 7-7, interrupt Vectors for the A Tm ega328 


Vector Interrupt 

Handler 

Description 

l 

INTO 

!WTo_vect 

External Interrupt 0 

2 

INTI 

lNTl_vect 

External Interrupt 1 

a 

PC INTO 

PClNTO_vect 

Pin -change Interrupt 0 

4 

PC INTI 

PClNTl_vect 

Pin-change Interrupt t 

5 

PCINT2 

PCINT2_veet 

Pin -change Interrupt 2 

s 

WDT 

WQ7_vect 

Watchdog timer (when used as an Interrupt) 

7 

TIMER2_COMPA 

TIMER 2_C0MPA_v ec t 

Timer/ Counter 2 compare match A 

S 

TIMER 2 COM PE 

TIMER 2_CGMPG_vec t 

Timer/ Counter 2 compare match li 

3 

TIMER2_OVF 

TlMtfi2_OVF_vect 

Timer/ Counter 2 overflow 

lb 

TIMER 1 _CAPT 

TlMEfil_CAPT_vect 

Timer/Counter 1 capture 

11 

TIMER 1 CO MPA 

TIMER l_COMPA_vec t 

Timer/ Counter 1 compare match A 

12 

TIMER l_COMPB 

TIMER l_C0MP6_vec t 

Tinier/ Counter 1 compare match b 

13 

TIMER 1 _OVF 

TlMEfil_OVF_vect 

Timer/ Counter 1 overflow 
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Continued. 


Vector 

Interrupt 

Handler 

Description 

14 

TIMERO. COM PA 

TIME ROjEQMP A:_y£ ct 

Timer/ Counter 0 compare match A 

15 

TIMERO COM PR 

TI ME fiQ_CGMP &_vect 

Timer/ Counter (i compare match B 

1(5 

T1MERO_OVF 

TIMERO_GVF_vect 

T Im erf Co u liter 0 overflow 

17 

SP1 

SfU_ETt_veet 

SP3 aerial transfer complete 

10 

IJSART_RX 

USARl_RX_veet 

I ISA RT reec Ive com pie te 

10 

USABTJJDRE 

USART_ED(tE_vect 

USART data register empty 

20 

USART _TX 

USAR1_TX_vect 

USART transmit complete 

21 

ADC 

AIX_vctt 

ADC conversion complete 

22 

EE READY 

EE_READV_vect 

E EPROM ready 

23 

ANALOG COMP 

AMALOC_COMP_uect 

Analog comparator triggered 

24 

TWI 

TWl_vcct 

Two -wire interface (I2C) event 

25 

S PM.. READY 

SPM_RtADY_vect 

S elf- p ro gra tit nt lug even t 

Ttibi* Interrupt Vectors for the ATmega256Q 

Vector 

Interrupt 

Hand lei 

Description 

1 

INTO 

II^TQ_tfect 

External interrupt A 

2 

INTI 

IliTlvect 

External interrupt 1 

3 

INT2 

IHTZj/ect. 

External interrupt 2 

4 

INT3 

lNT3_vect 

External interrupt 3 

5 

INT4 

INT4_vect 

External interrupt 4 

5 

[NT5 

IHT5_vect 

External Interrupt 5 

7 

INT6 

INT6_vect 

External interrupt (5 
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Vector 

Interrupt 

Hindi** 

Description 

a 

[NT? 

3Nl7_vett 

External interrupt 7 

9 

PC INTO 

PClNTO_vect 

Pin-change interrupt 0 

10 

PC INTI 

PEINTl_vect 

Pin-change interrupt l 

ii 

PCJNT2 

PCINT2 vect 

Pin -change interrupt 2 

12 

WDT 

IfJDIvect 

Watchdog timer (when used as an interrupt] 

13 

TIM EB2.COM PA 

TIME R2_CDMPA_ vect 

Timer/ Counter 2 compare match A 

14 

TIMER2_CQMPB 

TIMER2_COMP0_vect 

Timer /Counter 2 compare match B 

15 

TIMER2_OVF 

TIMER 2_0VF_vect 

T im er / Co u nter 2 overflow 

16 

TIMERI.CAPT 

TIME R l_CAP 1 _vcct 

Timer /Counter 1 capture event 

17 

TIMER l_CO MPA 

TIMER l_COMP A_vect 

Timer /Counter 1 compare match A 

IB 

TIMER l.COMPB 

TIMER 1_CQHP 0_ vect: 

Timer /Counter 1 compare match B 

19 

TIM ER1.COM PC 

TIME Rl_£GMPC_ vect 

Timer /Counter 1 compare match C 

20 

TIMEHl_OVF 

TIMER l_OVF_vect 

Timer /Counter 1 overflow 

21 

TIM11RE.COM PA 

TIME RO_CDMP A_vect 

Timer /Counter 0 compare match A 

22 

TIMEROCOMPB 

TIME RO_CQMP 0_vect 

Timer/ Counter 0 compare match B 

23 

TIM ERE _OVF 

TIMERO OVF vect 

Timer/ Counter 0 overflow 

24 

SPI 

SPl_ST£L_vect 

SFI aerial transfer complete 

25 

USARTQJ1X 

ilSARTO_RX_vect 

U SARTO receive complete 

26 

USART0_1JDRE 

OSAR T 0_Ui?R E_vcct 

U SARTO data register empty 

27 

U5ART0.TX 

OSAR ro_TX_ vect 

U SARTO transmit complete 

2ES 

ANALOG. COMP 

AHALOC_COMP_vect 

Analog comparator triggered 

29 

ADC 

AOCvect 

ADC conversion complete 
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Continued 


Vector 

Interrcpt 

Handler 

Description 

30 

EE_READY 

EE_ft£ADY_vect 

EEPROM ready 

31 

TIMERS^CAPT 

TlM£ft3_CAPT_vect 

Timer/Counter 3 capture event 

32 

TIMER3_COM PA 

I1MEK3 _COH PA_vec t 

Tinier/Counter 3 compare match A 

33 

TlMER3_COMPB 

TIMEK3 _COH P6_^ec t 

Timcr/Counter 3 compare match B 

34 

TIMERS^COM PC 

IlMEH3_C0MPC_tfect 

Timer /Counter 3 compare match C 

35 

TIM ER3_OVF 

IIMER3_0VF_vect 

Timer /Court ter 3 overflow 

36 

USART1_RX 

USAfi.Tl_RX_vect 

USAR1 1 receive complete 

3“ 

USART1JJDAE 

USAftTl_UDKE_vect 

US ART 1 data register empty 

36 

USARTl.TX 

OSAftTl_IX_vect 

IJSART1 transmit complete 

30 

TWI 

IWI_vect 

Two-wire interface (I2C) event 

40 

SPM_READY 

SPMJtEAOTveet 

Sc] F- prog rant sn ing e ven t 

41 

TIMER4_CAPT 

IlHEft 4 _CAPT_vect 

T i mer l Co un i or 4 ca ptur e eve n i 

42 

TIMER4 .COMPA 

TIME ft4_C0M PA_tec t 

Timer /Counter 4 compare match A 

43 

TIMER4_COMPB 

I IMEft4_.COM P6_vect 

Timer /Cou titer 4 compare match B 

44 

TIM ER4_COM PC 

IIM£ft4_C0MPC_vect 

Timer /Counter 4 compare match C 

45 

TIMER4_0VF 

TIMEK 4 _ 0 vF_vect 

Timer /Counter 4 overflow 

46 

TIM ER5_CAFT 

IlHEft5_CAPT_vect 

Timer /Counter 5 capture event 

47 

TIM ER5.COM PA 

TIME K5_C'0M PA_v ec t 

Timer/Counter 5 compare match A 

46 

TIM ER5_.COM PB 

TIME ft:S_COH P6_vec t 

Timer /Counter 5 compare match B 

40 

TIM ER5.COM PC 

IIM£ft5_C0MPC_veet 

Timer/Counter 5 compare match C 

50 

TIMER5.0VF 

TIMERS OVF vect 

Timer /Counter 5 overflow 
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Vector Interrupt 

HandLer 

Description 

si 

USART2_RX 

USAftT2_ 

RK_veet 

USART2 receive complete 

S2 

USART2JIDRE 

USAIfcT2_ 

UDkE_vect 

IJSART2 data register empty 

S3 

USART2_TX 

USAftT2_ 

TXvect 

USART2 transmit complete 

S4 

USART3. RX 

UWT3_ 

RX_vect 

USART3 receive complete 

ss 

USART3_UDRE 

USAkT3_ 

UDRL_vect 

US ARTS data register empty 

Sfi 

USAHT3JTX 

USAftT3_ 

TJtvect 

US ART! transmit complete 


Summary 

The exercises and experiments in tills chapter only scratch tire surface of what’s possible when hardware 
and software work together. Sometimes you just have to try Ii yourself and find out what works, what 
doesn’t work, and, more important, why. 

You now have an inkling of how to empower your peripherals to go out and work on their own 
without constant supervision, it's a good bet that you’ve already begun to think about Lite potential 
advantages this knowledge will bring In some of your Arduino projects. Some techniques will work 
heiter than you expected, whereas others will inexplicably fail. Both are good experiences as long as you 
learn something from ihem. 

Are you ready to put all this fancy book-learning to good use? You'll find several interesting LED- 
based projects in the next chapter. 

Enjoy the dance. 


CHAPTER 8 


Example Projects 



Making an LCD blink is a good first step, but of what other use is it? Specifically, is there any nontrivial 
application for this Interesting technology? Let's look a tone particular example: LED lighting. 

Here in the first decades of the twenty -first century, LEDs are taking tremendous strides in 
efficiency, reliability, and cost-effectiveness. They still lag a hit behind sontc older lighting technologies, 
hut today lt r s not entirely far-fetched to start experimenting with LEDs for the purposes of illumination, 
and not only as point -source Indicators. 

Blinking [he house lights on for a second and then off for a second runs out of novelty quickly. By 
blinking them very quickly and adjusting the duty cycle of [he blink rate, yon can effectively make a 
dimmable light. Dimmable lights are perfect for adjusting the ambient light levels to the appropriate 
function or snood desired. In addition, using the pulse -width -modular ion (PIVM) technique of adjusting 
the duty cycle so the perceived light level goes up and down achieves a great savings In power, with 
almost no waste at all. 

In this chapter you took at how to control several dimmable LEDs at once, build high-power LED 
drivers for high -power LEDs, use Infrared LLDs for remote control, and build really big arrays of LEDs. 
You also touch no the beginnings of a popular LED project, the digital clock. Let's get started! 


Beyond the Blinking LED: Starting Simply 

Listing fl-t illustrates perhaps the simplest possible Ard unto sketch that actually does something useful. 
Lifting, S-J. Dimming a Single LED with a Single Artluina Statement 

void setup() { 

} 

void loopO { 

analogWrite(llj analGgRcad(o) >> 2); 

} 


For this sketch to work properly, you must attach a variable voltage to the first analog lopul, AO. This 
is easily accomplished using a potentiometer, whose endpoints are connected to V i;i and ground and 
whose wiper contact {usually but not always the center pin} provides the variable voltage between the 
two potentials. A 10K linear potentiometer Is perfect. Then connect Dli to D13 using a short jumper 
wire, so the PWM signal on Dll drives the LED that comes standard on most Ard u inns on D13. 
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On the Ardulno Mega 2560, however, D13 is a PWM output, so no jumper wire Is. required. Just 
modify the analogwrite [) function to address Dlft directly. 

Alternately, you can go ahead -and wire your Ardulno to a small solderiess breadboard or other 
prototyping device. This gives you much more flexibility in how you connect your external components, 
as well as making It easier to make changes as you go along. See Figure ft- 1. 
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Figure B-I. A single 5mm LED and a potentiometer connected to an Aniuino it sing a pair of solder less 
breadboards 

When connecting additional LEDs to the Ardulno, you need to provide a current-limiting resistor In 
series with the LED. This prevents the LED from drawing too much current, which could damage either 
the LED or the Ardulno Itself. The LED installed on modern Ardulno boards already has Us own current- 
limiting resistor properly connected ro it. 
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Retail from Chapter? that [tie parametric ranges nf the Arduino 's analog functions aren’t [tie .same. 
The analcgWriteO function allows a possible range of 0-255. The analogfieadO function, on the other 
hand, tan return a value between Cl and 1,023, These ranges correspond to the eight-bit and ten- bit 
resolutions of the associated hardware, respectively. 

To translate the reading from the analog-to- digital converter (ADC) from a ten-bit representation to 
a more suitable eight-bit format, you use simple bit-shifting math: >> 2 . Each shift to the right divides 
the integer value by two. This tells [he compiler to take the return value of the analogEeadQ function and 
shift it to [he right (that is. toward [he least-significant bit) two times, discarding the lowest two bits and 
effectively dividing the result by four. You could just tell It to divide by four; hut because the result of the 
function call Isn't a constant, the compiler misses this potential optimization and includes the actual 
integer division subroutine from the avr-li.be library, thereby increasing the binary sketch size from 
1,076 bytes to 1,152 bytes. 

Alternatively, you could also use the handy Arduino rnapO function, which scales a value based on 
supplied ranges. The online documentation for the*ap() function uses this exact ADC-to-PWM scenario 
as an example: 

int val = analogHead(o); 

val - maptvalj. o, 1021 * o, 255); 

analogWrite(9j, val); 

These three statements can be more compactly expressed as 
ana!ogWritc(9* fnap(analogRcad(o), 0* 1023, 0* 255)}; 

However, this more -com pact rendering Is a bit harder to comprehend at first sight, with no 
measurable performance Improvement other [ban the omission of the declared integer variable, val. 
Example code should be as clear as possible In its intent and function. 

The problem with using the&apO function in this instance Is that il furLhcr expands the binary 
sketch size to l, SOS bytes. The mapiQ function is very handy when the input and output ranges bear no 
obvious mathematical relationship, because the values of the Arduino analog functions require only a 
small nudge to align properly, you can save some program memory. You may need it later. There is an 
even simpler solution, revealed later in the chapter. Slay tuned. 

How, then, to improve on this simple sketch? 3s It not already perfect? It performs its intended 
function. It takes up Utile space, It's easy for a human to read and perhaps understand, although it could 
use a few more comments [hint, hhuj. 

There are three major, If non -obvious, areas that could stand some Improvement. First, the sketch 
uses the Arduino analog functions, which can easily he optimized for both speed and ske. An additional 
restriction of the Arduino analog functions is their arbitrary PVYM frequency selection, which mayor 
may not be appropriate for your application. Because you haven't exactly defined the application in 
concrete terms, you 3 Lave to address that soon. 

The second area of improvement relates to the excess speed of the sketch's execution. It runs full tilt 
all the time, executing the loopt) function over 4,000 times per second. Such a high update rate is quite 
unnecessary in a lighting application, where the human eye has trouble seeing anything (aster than 
60Hz. In an o ptltn uni situation, the processor would shut itself down for a large percentage of the time, 
waking only when an adjustment was needed, thus saving a substantial amount of power. The milliwatts 
saved here are often Ignored in projects that control hundreds or thousands of watts of lighting, but 
that’s just bad form, and no excuse for waste. 

The third area for improvement Is either the most obvious or the Least obvious, depending on your 
perspective. This simple sketch matches one of six available analog Inputs to one of six available PWM 
outputs. The other analog inputs and PWM outputs are completely idle. Let’s expand the sketch to 
address this area of improvement first; see Listing 6-2. 
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Listing A Six-Channel Dimmer Sketch far the Ardulna if no 

void 4frtup() { 

} 

void laop{) { 

analog^? lte( ll , analogRcad{0) >> 2); 
afialogtfrite(lQ, analogRcad(i) >> 2 ); 
analogtfrite(&, ariaIogRead{ 2) >> 2); 
analogkrite(6, ana!ogRead( 3 ) >> 2); 
analogk'rite(5 , analogfiead(4) >> 2 ); 
analoghrlte(3 , ana!ogRead{ 5 ) >> 2 ); 

} 


Now the sketch is reading six channels of analog information and updating s-iit PWM outputs 
correspondingly- it can do this over 600 times per second, which Is impressive hut totally unnecessary. 
Let's pace tills sketch and make a few other optimizations along the way. 


Slow Enough 

3 low fast Is too fast? Anything much beyond the perception threshold of the human eye Is tno fast for a 
lighting application. Let's go far enough past this threshold to eliminate any visible 111 eke r. Something 
just over 1001 la should be perfect. Any higher than that, and you start to get into the audible range, 
which is a problem when you convert this project over to motor speed control (which is easily done, as 
demonstrated later). 

The default PWM frequency when using the Arduino anaLogWritc() function is -490 1 1 2 . That's too 
high for this lighting application. Let's slow it down by a factor of four by changing the prescaler of the 
associated timer/ counter peripheral. 

Recall from Chapter 7 that PWM output Dll Is driven by Timer /Counter 2's PWM channel A. (See 
Table 7-4.) The corresponding output pin is PB3 (Pori B, pin 3), which you callOC2A when it's being 
used as a PWM output. The Arduino software has already set up the PWM functionality for you. Vou only 
need to adjust the prescaler to get a more appropriate PWM rate. The prescaler already selected Is 
divlde-by-64. This divides the 16MHz system clock into a slower 250 KIIe clock that then drives the 
counter in the Timer /Counter 2 hardware. 

If you're doing the math at home (and you really should be), you may be curious how an 8-blt 
eou titer produces an overflow -490 times a second when driven at this clock speed (because 16,000,000 
+ 64 + 256 = -0763 1 2 ). The answer is that the counter Isn’t just counting up to the maximum value (253) 
and then rolling over back to 0. That would he the Fast PWM mode, which Is available should you need 
it. It’s one of the other PWM modes, known as Phase Correct PWM mode, or dual-slope mode. The 
counter goes up to the maximum value, then counts down to zero, then counts back up again, ad 
infinitum. This lakes 510 clocks to repeat. Vou might think It would take 2 x 256 - Si 2 clocks, hut the two 
endpoints aren't repeated (that is, the upper count sequence is 253. 254, 255,254, 253... and the lower 
count sequence Is 3, 2, 1, 0, 1, 2, 3). Therefore the formula to calculate the PWM frequency using the 
phase correct PWM mode is F CPU prescaler + 510, which gives you the familiar -49031/. number when 
the prescaler is 64. 

Change the prescaler to 256, and you get a PWM frequency of - 122112. This is good enough for now. 
Comparing the prescaler selection hits for Timer/ Counter 2 from Table 7-5, you see that only a single hit 
differs between the Ardu Inn-specified presealer setting of 64 and your desired prescaler of 255. Bit 6521 
in Timer /Counter 2's configuration register TCCR2B needs to be a I Instead of a 0. Let's take the easy road 
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for on ce and set that bit, muining everything else is just how you need it to be. Don’t fret; you return 
and address the issue properly In. good time. Add this single statement to the setup Q function: 

bitSel(TCtK2Bj C52i); // change Ti*er/courttei2: prescaler to CK/ 25 & 

This statement changes the PWM frequency of both DJ 1 and DLL because both of these PVV.M 
outputs (OC2.-\ and OC2B> are driven by Timer/ Counter 2. You adjust the PWM frequencies of the 
remaining two tinier/counter peripherals before you’re done with dimmers. 

lust looking at the LED, you shouldn't he able to see any visible difference In appearance. Turning 
the potentiometer knob up Increases the apparent brightness, and dialing it Track down again causes the 
LED to dim. if the knob seems to operate backward from this, try swapping lire V'.. and ground leads on 
the potentiometer. 

Or at least it appears to dim. In reality, the LED is never partially on or off. It’s either fully on or fully 
off part of the time. This is an important distinction, because It vastly simplifies the additional hardware 
required to drive larger loads. 

So now the PWM frequency is slow enough. What about the update frequency of the sketch? Mow 
can you slow it down from 600+ Liz without adding wasteful delay ( } functions or constructing some 
com pies sleep + wake-up algorithm? 

The simplest method is to use an interrupt. You already know that Timer /Counter 2 Is overflowing 
about 122 times every second. You can move the actual code to update the dimmer Into tin interrupt 
service handler and enable the overflow interrupt. Instead of copying and pasting all that code Into 
another Function, simply rename the lccpO Function to I5R{tIMER2_0ivF_veet) and then create a new, 
empty loop() function, so that your sketch now 1 looks like Listing fl-3. Don’t forget to also add the 
additional statement In the sclup[} function to enable the timer-overflow interrupt; otherwise nothing 
interesting will happen. 

Lifting 8-3. A Six-Channel Dimmer Using Slower PWM and an Interrupt Handler 

void setupO { 

bitSet{K£R2&, CS2i)j // change Tirtier/Counter2 presealer to CR/256 
bitSet{flMSK2, lOIEl); // enable Timer/ counters overflow interrupt 

} 

void loop{) { 

// nothing happens here 

} 

ISR(TIMEK 2_0V E_vc c t ) { 
analogVrite(il, analogR ead(o) >> 2 ); 
analogWrite(lO, analogRcad(i) >> 2); 
analogkrite(9, analogRead( 2) >> 2); 
analogWrite(6, anaiogl!ead{3) >> 2 ); 
analogtfrite(5, anaIogRead(4) >> 2 ); 
analogVrite(3, ana!ogRead( 5 ) >> 2); 

} 

Now all the updating is done in the background by the timer-overflow interrupt, leaving the loop{) 
function delightfully empty arid ready for other tasks. This approach is still a little faster than you need to 
actually update a single channel. 

The operator of the light dimmer expects a change in the output of the dimmer when the input Is 
bid jus ted. This change needs to respond In real rime- that is, there can be no perceptible delay or lag in 
the response of the system. The key word here is perceptible. As long as something happens within a 
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small fraction of a second, [he mser is convinced iliac the system is responding appropriately and briskly 
10 their commands. This generally makes users happy. As you may already begin to appreciate, a small 
fraction of a second is plenty of time for an Arduino to execute thousands of tines of code. 

Let's add a hit of finesse to the interrupt service routine, so thac it only updates a single channel 
each time It’s invoked by the overflow interrupt. You add a static byte declaration within die function 
definition to keep [rack of which channel needs servicing next. The static keyword ensures that the 
value of the variable persists even after the routine esdts. You then define a list of the PWM pins In the 
form of a const byte array. You can use the value of the channel variable to look up the correct PWM 
output pin In the list. The channel variable is substituted for the constant values used previously In the 
update statement. The channel number is then Incremented for next time through the loop and rolEed 
hack to zero when it gels Loo large. All of these changes are made in the interrupt service handler itself, 
and no other modifications to the sketch arc required. See Listing 8-4. 

Listing 8-4. At j Even Slower Update Rate far the Six-Channel Dimmer Sketch 
lift (TIME Ra_OYF_veet) { 
static byte channel = 0; 

const byte pwm_pins[6l = { 11, ID, 9, 6, 3 }; 

analogKr its Ins [ channel], a naiogftead{ channel) » 2); 
channel *+; 

if (channel > 5} channel = oj ii roll over 

} 

Each channel is now updated Just over 20 times per second. The average person will perceive tills as 
an instantaneous response to the adjustment of the potentiometers. 


Tip Listing 8-4 is an exam pi b of a simple state machine, ft's implemented as a function that is periodically 
invoked, and it retains some record of its present state. If quickly performs some state-specific action, which may 
or may not alter the state, and then exits. A state machine can get all kinds of complicated, hut this one is very 
simple. The state in this example is the current channel. 


Mostly Optimized Six-Channel Dimmer 

As promised. Listing fl-5 shows the mostly optimized sketch for runnings six-channel dimmer circuit in 
the background. 

titling fl-J. The Mostly Optimized Six-Channel Dimmer Sketch 

void setups) { 

// output ports 
DDfcB = OxFPj U all outputs 
UDRD = OxFF; H all outputs 
// ADC 

AUMUX. = 0«KEF5l | IccREFSO | KcADLAR; 
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flOC.SK A = 1<<ADEM | i«ADSC | 1«ADPS2 | l«ADPSl | l^ADPEO; 

OIDHC- = lC^ADCSD | i<cADC40 | KcADClD | 1<.<ADC2D | 1<<ADC1D | lCSADCOD; 

// Timer/eounterO 

TtCROA = iCCCOMftAl I OccCOMOAO | 1C<COHOB1 | O«C0MOBO | DS<WGM01 | l< <LilLKOO ; 
TCCROB o 0<<WiiH02 | 1<<CS02 | OcctSOi | ft«CSOQ; 

// Timer /count eri 

TCCftlA = lccCOHlAl I 0<<COMiAO | l<:<COHiBl I OccCOfliBO I D<<WCiHll | lccUGNlft; 
TttftlB = OccbJGMlj | QccKGMl 2 | ictC$12 | OteCSll | Q«C£lD; 

// Timer/counter2 

TCCR2A = l< <CGM2Al | Oc<C0M2AO | ie<COH201 | 0<<CDM2B0 | ft«WGM21 | 1«UGM2D; 
TCCR2& = 0<<WGH22 | L<<CE22 | 1«CS2.1 | 0<<CS20; 
bitSet{IIMSK2, I0IE2) j // enable overflow interrupt 

J 

void loop{) { 

// nothing happens here 

} 

ISR(TiM£R2_0Vf_vect) { 

static byte channel = 0; 
byte adc; 

adc = ADCR; // read upper 8 bits of ADC conversion result 


switcla{ channel} { 


case 

0 : 

OCR 2 A = adc; 

break; 

// 

PWM pin. 

Dii 

case 

ii 

OCR IB = adc; 

break; 

// 

pwm pin 

DlO 

case 

2: 

0CR1A = adc; 

break; 

// 

Pwm pin 

D9 

case 

3: 

OCRQA = adc; 

break; 

U 

PWM pin 

D6 

case 4: 

OCR OB = adc; 

break; 

// 

PWM pin 

D5 

case 

5: 

0CR2B = adc; 

break; 

// 

Pwm pin 

D3 


} 

channels; 

if (channel >5} channel = 0; 

ABMUK = Oc<R£FSl I KcREFSO | iccflULAR | channel; 

fl.OC.SKA = lccADEN | IccADSC | 1«A0PS2 | KtADPSl | l«ADPSO; 

J 

Despite how lengthy this sketch may seem from a source-code perspective, it compiles down to a 
skinny B5B bytes, smaller even titan your faithful friend Blink. This is mostly due to abandoning the 
Ardulnn analog functions and writing directly to the registers when possible. 

One additional step that had to he taken was to explicitly sec Lhe PWM output pins to outputs, by 
writing to the data direction registers of hoth Port B and Port D. The Arduino analogvritcf ) function 
took care of this for you In the previous Incarnation of this sketch. 

The timer/ counter peripherals are all properly configured for eight-bit phase-correct PWM duty. 
Timer /Counter 2’s overflow interrupt enable bit r T0IE2, is set to 1 In the TiMiK2 register. This allows the 
timer to generate a periodic interrupt when it overflows. 

The ADC peripheral is configured slightly differently than normal. An option exists to have the 10- 
bit conversion result left-aligned In the IB-bit result register. You select this option by programming a l 
into the ADLAR bit it) the ADC’s ADC ERA configuration register. This allows the interrupt service routine to 
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read only tli-c upper eight bits of the conversion resole, which is ail you wain, and disregard the two 
lowest hits. This obviates the hit -shifting math from Lhc previous sketch. 

Because bill six of the analog inputs are being used in their analog capacity, the digital Input circuits 
associated with those pins are disabled by setting tbe bits in lhc Digital input Disable Register, DlLRu. 
This saves a little power, but more Important, It prevents Strange Things front happening when the 
digital inputs try to make heads or tails (that Is, ones or zeros) out of the (possibly) constantly varying 
input voltages. They just wouldn't understand, so you shut them down. 

As before, nothing happens in the ltropO function. Perhaps you can think of something clever to put 
there. 

The Interrupt handler gets a few changes. A switch [) statement based on the channel variable 
replaces the table lookup for the assignment of the conversion result to the proper PWM output register. 
The channel number Is Incremented, as before. The ADCs Input multiplexer is then pointed at the new 
input channel, and a new conversion is started. 

The ADC’s status bits need not he examined because you've given the peripheral more than enough 
time in complete a conversion. 

By reconfiguring the prescaler of the Tlmer/Counier 0 peripheral, the built-in Ardulno timing 
functions such as delay () andaiilisf) no longer work as expected. You do, however, have a nice, 
regular heartbeat In the TLmer.2 overflow Interrupt, so you could use that for tinting duties, If needed. 

Why is this example sketch called mostly optimised? Because there are a few more things you could 
do to it, of course. There always are. 

To start, you've been pretending that Timer /Counter I Is an eight-bit counter with two PWM 
channels associated with It. In reality, it's a 16- bit counter (with 2 PWM channels associated with Jr), taut 
it also offers both a 9-bit and a 10-bit counter mode, each with Fast PWM and Phase Correct PWM 
modes. The ten-bit mode exactly matches the output precision of the ADC peripheral, so it would he a 
better fit to program it accordingly. Don't waste those two extra bits if you don't have to. 

To prevent flickering, especially at the lower end of the dimmer range, you could add some sort of 
filtering algorithm, such as sittw-ttia limiting, which would prevent the output from jumping rapidly 
from one value to another. This gives an Impression of smoothness to the overall performance of the 
circuit and, done properly, adds a professional -level fade effect to the lighting transitions. 

Finally, If you realty can’t think of anything clever to pul in the loopO function, consider fruiting the 
processor to sleep, using the functions provided in the avr-Iibc library. 

Now it's time to hook up all these pots and LEDs and see what happens; see Figure 8-2. it’s really not 
as bad as it may look at first glance. You should be able to see that it's just a repetition of the basic circuit 
from Figure fl-1, with six Input potentiometers and six output LEDs, which are duplicates of each other. 
Note [he use of [he power rails along lire edges of tire solderless breadboards: these allow multiple 
signals to be connected together. On the Lop breadboard, all [he ground connections for the LEDs arc 
connected together, and a single wire runs baek to the GND pin on the Arduino. Similarly, both [he 5V 
and GND connections to all the pots are connected via the two power rails and then routed hack to the 
5V and GND pins on the Ardulno power- expansion connector. 
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Figure 0 -2, The begin n ittgs of a six -chan nel din r m er circa it, for expert m en ml pit eposes 


It's Dim, Alright 

You took ail LCD that was probably none -too -bright to begin with and made Li even dimmer. This 
doesn’t qualify as Illumination yet. What do you need, to go from a single LED to something that actually 
Eights up a mom? 

The answer Is simple: More Power! This breaks down into two basic areas: 

• Getting the power 

* Contro Hi n g i he power 
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The typical USB- powered Ardulno has a little power to play with, as. far as lighting up some LEDs 
goes. Let's figure out exactly how much power there is to go around, before hooking up the Jumper 
cables. 

The USB specification, which is available for your perusal at the USB Implemented Forum web site 
(Vwh.usb.org), provides for up to 5 Ohm A (O.SA) at somewhere around 5 V to be supplied to a USB device 
that properly enumerates itself on the bus. That's two and a baif watts, maximum. This power can he 
used for whatever purpose the USB device needs. For an Ardulno, there is the power consumed hy the 
AT mega processor itself, along with the USB interface and the always-on power indicator LED, and 
sometimes the TX and RX LEDs, and possibly the built-in LCD on D LI. All this doesn’t add up to even 
one watt, so there’s a Eitile room left in the power budget to light up a few more LEDs, or possibly one big 
LCD. 


A Little LED Math 

How much power does a small LED draw? Electrical power Is expressed in units called watts and can be 
calculated by multiplying voltage by current. Voltage is measured in volts (labeled with the capital letter 
V/ and current flow is measured in amperes, often abbreviated asnmps nr just the capital letter A. 

A typical, red Indicator LED draws in the range of 20mA (0.02A) bit around 2.0V. Other colors 
generally require more voltage as you go further up the rainbow. In terms of power, this rt.-d LED’s power 
requirement Is calculated as G.C2A x 2.0V - 0.04W, or 40 milliwatts. That's not very much, which is one of 
the reasons why you see little indicator LEDs everywhere. 

Unfortunately, they add up. Recalling from Chapter .1, you know that each of the DO pinson the 
Atmei AVR can sink or source up to 40mA at 5.0V. That’s perfect for driving LEDs! However, you can'i 
drive two 20mA LEDs from every pin of the chip (at least not at the same time) because of the 200mA 
overall device limitation. This limit applies to both the ATmega32S and ibe AT mega 2560 devices. You 
tvujMbook up an LED to every single pin, but you'd have in promise not to turn them ali on at the same 
lime. At most you could drive ten of these littie, red LCDs ai full current, which still isn't a good idea 
hecause it leaves no room for anything else to be driven hy the chip. 

Even if you did connect 20 high -efficiency super-bright white LEDs to the Ardulno, with suitable 
current-limiting resistors to keep the current to each LCD under 10mA. thus abiding hy the overall AVR 
device curreait limit, ynu still wouldn't have that much light output — maybe enough fora night light or 
even a reading lamp, if it was close enough. More power Is available on the Ardulno. hut you can't run it 
directly through the processor itseif. Vou need an LED driver. 


A Small LED Driver Circuit 

Ynu can use a single transistor with a couple of resistors to build your own LED driver circuit. The 
transistor acts as a current amplifier in this configuration. It takes a very small amount of current tn turn 
on the circuit. Illuminating the LED. This is what you need to lower the current requirement from the 
processor. See Figure fl -3. 
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IK 



Figure A single- LED driver circuit 

fi Is [he connection heck to one of the Arduino output pins. It could he a PWM output or any of the 
ocher digital outputs. R1 controls the amount of current that flows out of the Arduino pin and into the 
hase of the transistor. This Is your main concern right now: limiting the amount of current drawn out of 
the Arduino 's pins, because there’s only so much to go around. 

The amount of current flowing into tire base is directly proportional to the amount of current 
flowing from the transistor’s collector to Its emitter. Because the output of tire Arduino pin will be at 5V 
when the pin Is driven to a high slate, the amount of current flowing through the resistor R l and into the 
base of transistor Q] will he at most j V + I ,60011 - am A 1.6.005 A), according to Ohm’s Law. In reality* the 
current will be less, because Inside the transistor* between the base and the emitter* Is a p-n function, the 
intersection of P-type and N-type semiconductors. This junction is electrically similar to a diode, so 
there Is a voltage drop. In your example circuit* you use a silicon transistor whose typical junction 
voltage drop Is between O.GV and 0.7V at negligible current levels, going up exponentially (as 
semiconductor voltage-current curves tend to do] as the current increases. You should see Just over 4mA 
(but no more than 5mA because of the resistor) flowing from the pin of the Arduino through rbe base 
resistor R l and into the hase of the transistor. 

Drawing only five mill! amps or tess per pin is perfect for the Arduino Uno. You could, in theory, 
connect a driver circuit Like this one to every single pin at the same time and still be using less than half 
of the allowed current flowing out of the chip. This assumes a maximum of 20 outputs x 5mA = 100mA* 
which means you’re using the USART pins as outputs as well as all the analog Inputs. 

You could eve n attach as many as 40 to 50 of these driver circuits to the Arduino Mega 2560, hut this 
would he pushing it right up to the limit. Increasing ihe value of R1 from 1 KTl to 1.5K11 would lower the 
current requirement of each driver hut correspondingly decrease the amount of current that could be 
switched on and off by the driver circuit. 

The amount of current that can How through the transistor* connecting the circuit that powers the 
LCD* Is calculated by multiplying the base current by the transistor's DC current gain factor* abbreviated 
h M . A common, small-signal transistor such as rite PN2222A lias a minimum b , of 50 when the base 
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current is as little as 1.0 mA. This means If you apply 4 mA of current to the base of a PN2222A transistor, 
it can conduct a minimum of2QQmA (0.200A.I from the collector to the emitter. That's right: tills simple 
circuit can sink as much current as an entire ATmega device. Tills gives you a little more low -cost 
electrical muscle for driving your LEDs. 

If you apply more current to the base by lowering the value of the base resistor, more current can 
flow through the transistor. Correspondingly, less current into the base nvfnces ihe maximum current 
that can How In the circuit. The maximum collector current (I ) of the PN2222A transistor is 1.0 A. 


A Little More LED Math 

The actual amount of current that flows through this circuit Is determined by two Important factors: the 
forward voltage of the LED and the value of the current-limiting resistor that Is in series with the LED. 
There is also a small amount of voltage dropped across the collector-emitter path of the transistor itself; 
hut it will be very small (dozens of millivolts) when the current Is relatively small, as it Is in the single 
LCD driver. 

The forward voltage of the LED is tricky, because It varies exponentially with the amount of current 
flowing through the LED. The manufacturer's datasheet for any given LED only publishes a range for the 
forward voltage, because it varies even further front lot to lot as well as from LED to LED. 

The best way to determine ibe forward voltage of an LED is to connect It to a power supply that 
allows either the voltage or the current to be varied, while also connecting an ammeter in series with the 
LED to measure the current flow. Starting at zero, slowly adjust the power up until either the desired 
brightness Is achieved or the maximum current for the LED is reached. The maximum current should be 
given In the manufacturer's datasheet. 


Caution Remember that maximum means maximum. Ft's a had idea to over-power an LED. 


Then, when the current through the LED has been established, measure the voltage across the 
terminals of the LED. This is the exact voltage drop for this particular LED at this current ... at this 
temperature. Note that the numbers change as the LED heats up. For small Indicator LEDs, little heat is 
generated; hut this Isn’t the case with any of the larger LEDs now available for Lighting applications, 
which can easily get so hot they need a heatsink to draw away the heat, lest the LED burn up. 

Using a typical red LED as an example, you can safely assume a maximum current of 25mA and a 
forward voltage around 2.0V. Fully illuminated, this LED draws only 50 mW, or L X 20 of a watt. That's not 
much power at all; it won t get unduly hot, and you can safely experiment on it without tongs, gloves, or 
safety masks. 

If the LED is dropping 2.PV across its terminals, that means the remaining voltage in the circuit (5.0V 
- 2.0V - 3.0V] is going to be dropped across the current-limiting resistor, to he dissipated as waste beat. 
Because you now know what the voltage across the resistor should be, you can select an appropriate 
value fin ohms) for the resistor to give you the amount of current you want flowing through the circuit; 
again by using Ohm's Law. To calculate the optimum value of the current -limiting resistor, you divide 
the voltage across its terminals by the desired current flow in amps to get [he resistance value in ohms, 
or 3.0V 4- 0.025A = 1 2 Oil. 

Because 120D happens to be a common resistor value for 5% tolerance resistors, you can stop there. 
Had the number turned out to be some weird fraction, you xvould simply round up to the next -most- 
common value. 
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Thai was the process in determine the resistance of the current-!! mi ting resistor, It's also necessary 
to calculate the power- handling capacity needed Lit this circuit. You may recall that power is the product 
of voltage and current, and because you’ve already calculated these values (3.QV and 0.025 AJ, you need 
only multiply them together to find the power that Is to he dissipated hy the resistor in the circuit: 3.0V x 
0.025A = 0.075W, or 75m W. 

A very common power rating for small resistors is 1 /4W r or 250 mW, so you can easily use a quarter- 
watt resistor in this circuit. There Is plenty of excess power- handling cap ability. You want more capacity 
than demand in this example. You don't want to use a quarter-watt resistor when the power requirement 
gets ahove200mWor so; the resistor will get uncomfortably warm. Move on up to a half-watt resistor to 
he on the safe side. 

Because the current-limiting resistor docs away with the excess power In the circuit by converting It 
into waste lu.-at, the resistor tends to warm up during use. For your little red LED example, It probably 
won't get very warm at all. This will change when you move on to bigger LEDs. 

So all that math tells you that you can use a 12011, 1MW resistor for R2 In your driver circuit, if you're 
using the red LED you imagined you were going to use. What about other colors? Yellow LEDs tend to 
share the same forward voltage characteristics as red LEDs, generally somewhere in the l.HV to 2.4V 
range. Green and blue LEDs can have forward voltages In the range of 3.0V to 3.fiV. as well as white and 
ultraviolet (UV] LEDs. Your voltage may vary. 

Some multimeters offer a diode test mode that measures the forward voltage of diodes or LEDs, but 
this is usually at miniscule current conditions— typically Less than one in ill Lamp. This is useful for giving 
an absolute minimum value for the LED's forward voltage- in practical applications, it most certainly will 
be higher. 

One additional feature of your simple driver circuit is that it can easily drive ntore than a single LED, 
as long as the total current through the transistor is below the maximum collector current (and 
assuming enough base drive current). Let's add some more LEDs to this circuit. See Figure 43-4. 


fc'cc I'lt In Ycx III Ik Is: lec h'cc Voj 



Figure 8-4. Multiple LEDs driven at full brightness fjy the same output pin 

Note that all these LEDs come on and go off together, as one. However, ibis is sometimes what you 
want. The values for the individual current-limiting resistors are based on the theoretical forward 
voltages shown in tire schematic. 

If each LED in this driver circuit Is running at 25mA, this one-driver circuit is now switching 250mA, 
about half of the total power available if the Arduino is being powered by the USB cable. You could, in 
theory, attach as many as two of these circuits to an Arduino without having to supply power from a 
different source. Luckily, the Arduino Is already provisioned for this eventuality. 

This circuit doesn't scale in a perfectly linear manner, however. The additional current flowing 
through the transistor increases the voltage drop across the transistor, thereby reducing the voltage 
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across the LEDs and their associated cm rent-limiting resistors, This voltage drop should only Increase to 
about 0.250V using the components shown In Figure fi-4, but even this small change diminishes the 
brightness of each of the LEDs somewhat, with the most visible difference being seen with the hlgber- 
voltage LEDs such as Lhe white and IJV. 


A 1W LED Driver 

You have 2.5W of electrical power available on the typical USB -powered ArduLno, less a small amount to 
drive the native circuitry. Let's push one of those watts through one big LED. See Figure ft- 5. 



Figure &-$. A 1 W white LED. attached to tin alumtnum-care PCS as a heatsink 

A IW LED is becoming more commonplace. The LED Lit Figure 11-5 was obtained from overseas via 
eBay for about one US dollar. The only documentation that came with It was a printed on the bag label: 

"1 pcs l IV White Lumen LED 401m." There were no electrical specifications, other than the ]VV figure. 
Luckily, most of these (but not all!] LEDs are similarly constructed, it was a good bet that it required 
about 3 50mA and had a forward voltage between 3.0V and 3.6 V. Empirical testing revealed a forward 
voltage of 3.250V at 330mA at room temperature, or -1.14W. Do take note that this IW rating describes 
the LED's power requirement and notits optical output power. 

After the part had been running for about IS minutes, Its temperature stabilized at about 2STJ above 
ambient: not terribly hot, but war so me thing you want lo touch with your own, personal fingers. The 
forward voltage also declined to 3.204V ae operating temperature. No additional heatsink was attached 
to the aluminum- core PCB. 


Caution Don’t look directly at LEDs intended for ill u mi nation purposes! 
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Driving this LCD directly from a 5 V source should require: a SJJfi resistor ('{5.0V - 3.204 Vl -i-O.SSOA] 
that can safety dissipate fust over 627 mW of power. The standard value of 5. lii is really efese but just a 
fraction of a percent too small. rite next standard value in the E24 scale ls5.5ii. A full 1W power- 
handling rating for this resistor wouldn't be amiss here. 

You can also build one big resistor out of a few smaller resistors. Five Ifl resistors In series provide 
enough resistance, and the power rating can he distributed among them* so even 1/4W resistors would 
work. When in doubt, use a lugger resistor. You can also wire two idii resistors In parallel, halving their 
resistance but doubling their individual power-handling capacity. 

The single LED driver circuit presented In Figure 33-2 will work with this LED, bui with only one of 
these LEDs ai a time. Dropping the value of the base resistor from IKi'i to 6fl0 or 56D ohms would help 
ensure enough current was able to flow from the Arduino pio to the transistor. Again, you only need to 
make sure that the current flowing either into or out of any Arduino pins Is less than 40mA per pin. and 
that the total of all pins is less than 200mA. 

Why can only one of these 1W LEDs he connected at once? isn't there 2.5W of discretionary power 
to go around? The LED described in this experiment is using 1.14 Wall by itself, radiating perhaps as 
much as 10% of that energy as visible light and the remainder as waste heat. The current-limiting 
resistor, if you recall, Ls also spending part of the power budget, radiating 100% of the electrical power 
flowing through It (1.796V x 0.350 A _ 0.62S6W) as waste heat, almost 2/3 of another one of your precious 
watts. So that's over 1 -3/4W being used already. 

Another way to look at Itls strictly front the current perspective: You’re using 350mA of the available 
500mA that can be supplied by your USB cable, not counting what the rest of the Arduino circuit needs. 


A 10W LED Driver 

Packing even more of a punch, 10W LEDs are now available at reasonable prices. These LEDs rnusirbe 
mounted to a heatsink to draw away their excess heat. This step Is no longer optional at these power 
levels. See Figure ft -6. 



Figure i-9. A MW white LED attached to an aluminum heatsink. The metal labs an the left and right of 
the LED are the electrical connections. 
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As you may or may nm lie able to see In the photograph, the I GW LED is. really an array of il 
individual LEDs, organized in a 3 x 3 array. Cach of the Individual LEDs buried within the array is similar 
iii characteristics to the single IW LED examined earlier, 

Because there are three parallel strings of three LCDs In series in this array, both the forward voltage 
and the current requirements arc tripled. The LED needs around lGVat J DA flOW) to operate at full 
capacity. This exceeds the power supply of an Ardulno that Is powered only by a USB cable. Because the 
Arduino retains Lis pre-USB power-supply circuitry, all you have to do is find a suitable external power 
supply, and you'll be on your way to controlling this much larger LED. You’re now officially entering the 
realm of LED lighting, although still aL a modest scale. LEDs of this stature generally emit in the range of 
SflO to 9GD lumens of light, which is comparable to a 40 W nr SOW incandescent bulb. This underlines the 
higher efficiency of LED lighting when compared to some, but not all, of the preexisting lighting 
technologies. 

Let’s build a driver circuit for this LCD and connect it to an Arduinn. Your faithful friend the 
PN2222A transistor has to bow out at this paint. The I.OA continuous-power requirement happens to he 
the PN2222 A '& absolute maximum collector current (E ), so you can either look for a larger bipolar 
junction transistor (BJT'l or try a different kind of transistor entirely. Let's look at a proven contender in 
this field: the [RLZ44, a logic- level power metal oxide semiconductor field- effect transistor (MOSFET ), 
originally from International Rectifier and now produced by Visit ay. See Figure fl-?. 



Figure & -7. A single LED driver for a TOW LED using a MOSFET 
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The overall layout of [his schematic should look quite familiar by now. The BIT has been replaced 
with a MOSFET, which has Its own schematic symbol that more accurately describes its inner workings. 
The single LED has been replaced with a 3 * ft array of LCDs, even though tbeyVe alt packaged within the 
same device. The values of the two resistors have been modified for this new circuit. A new resistor. R3, 
has been added. 

Fil still limits the amount of current flowing into the gate of the MOSFET. This kind of transistor Is 
controlled by voltage instead of current, uolike the previous BIT. You'll note a gap within the MOSFET 
symbol between the gate and the other two terminals, the source (connected to ground} and the drain 
(connected to the LED. and so on). This gap reminds you that there is no direct electrical connection 
between these terminals. A voltage on the gate Induces an electrical field that creates an enhancement 
region in the transistor, causing It to conduct current. 

Because the two conductors are separated by an Insulator, there is a small amount of capacitance 
on the gate. This capacitance must be charged before the voltage on the gate wilt rise high enough to 
turn on the MOSFET, so for a very short amount of time, a very large current can flow into the gate. You 
want to limit the peak value of this in-rush current while at the same time not Introducing much delay. A 
small-value resistor, measuring just a few ohms, will work nicely. Once the gate has been moved to the 
higher voltage level, it takes practically no energy to keep it there, unlike the HIT that always conducts 
the base current out through the emitter. 

Due to the capacitive nature of the transistor's gate, it can’t be left floating (that is, with no input) at 
any time. A new component. R3, very loosely ties the gate to ground, keeping the transistor turned off 
until a real signal arrives from the Arduino. Remember, the Ardulno takes a moment to compose itself 
whenever it has been reset or first powered up, and In that period of time all the I/O pins arc still Inputs. 
Stray electromagnetic energy in the atmosphere can easily be converted to enough electrical potential to 
partially or fully turn on the transistor. This Is something that you do not want to happen. 

IfV |s Is a regulated 12V supply. R2 should be (12.0V - iO.OV) + l.OAj. or 2ft with a2W minimum 
power rating. Three-, four-, or even five-watt resistors would be welcome here, lust as with your friend 
the 3 1 N2222A transistor, let's not ask these parts to run at 100% alt the time. 

if you're tired of calculating ail these resistor values, you can lake a break. There are many prebuilt 
12V lighting products available now that feature LEDs. Figure B- B shows alow -voltage MR- 16 lam p being 
driven by the circuit in Figure fi-7. 



Figure S-B. A low- voltage LED lump with built-in drive electronics 
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One: of the decided Sy nice things about these self-contained Sow-voltage Lighting devices is that they 
already contain their own drive electronics. They run on either 12V AC or DC, so It doesn't matter which 
way you connect the Leads;. Several of these Lamps, can be controlled by a single driver circuit such as 
presented in Figure B-7. 


Other Uses for a Blinking LED 

LED lighting is one of the snore fascinating applications of blinking LLD technology. On a smaller scale, 
some other uses can prove handy, as well. One of them Is using LEDs for communication. 


Infrared Remote Control 

3fs quite possible that you’ve already used an LED to send a message today. Most consumer electronic 
devices that support a remote control use one or more variations of Infrared (IR) remote- control 
protocols. These devices blink an infrared LED on and off quickly, using different timing patterns to 
co n vc y di f ferent co m ma n d s. 

The typical ill remote control uses a 940nm 3R LLD. ThLs wavelength Is just past (he red end of the 
spectrum that Is visible lo humans. You don't see any flashes of light coming from the end of your 
remote control, but your digital camera or camcorder very probably can. This useful piece of 
information can also be used to develop see- In -the- dark equipment by building Large arrays of infrared 
LEDs and using suitable cameras to do the actual seeing part. Sadly, no Arduino is required. 

However., if you do want to use your Arduino to send and receive IR remote- control commands, it's 
relatively easy, once you've hooked up the right hardware. 

The IR transmitter is just an LED, like any LED you’ve blinked so far. A typical 5mm 3R LED usually 
has a maximum continuous current of 1 00mA and a typical forward voltage of 1 .2.V-1 .SV. You can attach 
an IR LLD directly in an Arduino pin through a l Ot)£l resistor, but it won't transmit very far. hecause it's 
only getting about 40% of the power it’s expecting. In normal service (that is, soldered to a re mote - 
control PCB) r these IR LEDs are often badly abused, sometimes simply shorted across the battery 
terminals for the brief time they need to be on, with Little or no current-limiting provided. This increases 
effective distance at the cost of longevity. 

You can get more range by adding the single LED driver from Figure 6-3 and lowering the resistance 
of the current-limiting resistor to 47ii. This increases the current flowing through the LED to around 
IhOmA. A half-watt resistor is recommended, even though the low duty cycle of the LED tells you the 
mterage cur rent of the LED Is less than the maximum. It's entirely possible that a software glitch could 
leave the LED on, and you don’t want to have to explain why the lab burned down. 

The IR receiver is a bit more complicated. You can build one out of an infrared photodiode and a 
bunch of other analog circuitry, or you can buy one already made in a tiny module that works perfectly. 
There are several popular models made by different manufacturers. The PN4602 by Panasonic is a good 
choice. It has only three connections: power, ground, and decoded signal out. These highly integrated 
devices are made by the millions for all those consumer electronic gadgets people seem to keep buying, 
so their cost is quite low. 

For best performance in variably lighted environments, the IR signal is usually modulated at so me 
predefined frequency. A very common frequency is LliiKID. 

A delightfully useful library for IR communication is available from Ken ShirrlfTsblog 
(*-nu . arc f n . com/ 2009 /OB/ mu It i - m ul tl pr atocol. -lnfrared-r emote -lib rary , total ) . D o w n Eo ad th e ?.\ p fi Le 
and unpack it in your Arduino 's /libraries/ folder. Lt even comes with several useful demo programs, 
which you should be able to load from the Arduino s File > Examples > IRremoie menu Item. Use the 
IRrecvDump sample sketch to identify. If possible, the codes coming from your IR remote. Jot down the 
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codes emitted from a few buttons; then you can use those codes In your own sketch, simulating die use 
of the remote control. 

The example sketches connect the [R transmitter circuit to DL'l and the JR receiver to Dll. The 
output pin Js chosen because Ken used the PW.M capabilities ofthe Atmel AVFt to help with Lite 
modulation of the output signal. The Input pin can beany digital Input pin. 

Listing B-fi gives a simple sketch that alternately turns on and off an I Ft remote-controlled RGB LED 
controller. 

Listing s-5. A Short Sketch Using tise IRremote Library (On eirnl Off Cories Decoded Using the Library's 
IRrecuDump Example Sketch} 

flinclude clftremote.h^ 

Ik tend Irsend; 

void setup() { 

} 

void loop 0 -[ 

irsend.sendNEC(0.xFFBCi4F, 3.2) j. // on 
delay (l 000); 

iisend.sendNECtOxFFFBO?, 12); // off 
delay ( looo ); 

} 

The library supports Sony, NEC. and RCSI6 codes, which should cover a large number of IR remote- 
control devices. 

Now you have an Arduino that can control several different lights at once. It can also send and 
receive Infrared re mote- control codes. Can you Imagine any Interesting combinations of these two 
capabilities? 


TV-B-Gone 

Mitch Altman (shown in Figure B-9) is a very interesting man. lie wants you to be happy. I le has an idea 
that if you spent more time doing the things you love and less time watching TV, you’d he a happier 
person. He may be right. 


183 


CHAPTER B EXAM f^E PROJECTS 



Fig ure3~9. Mitch Altman. PStota by Alexander Ktink. Image licensed under Creative Commons 
Attribution 3.0 IJnpaned. 

Mitch travels a found the world teaching people to solder, and otherwise empowering people to 
change tire world to he a better place to live. One of Ills inventions Ls the TV-B -Gone (wfc^tvbgone.comL 
which Is a universal TV remote control that has one button. Can you guess what that button does? Yes, 
that's right: it turns off almost every TV known to man that is within range. Mis Invention is quite simple 
in Its mission as well as in its execution. It’s an excellent example of a popular open source project. 

Looking at the schematic, available from the Adair u it website 
(iknM.ladydda.nety[nake/tvbgenc/downlead.ht.rnlj F you can see that It r s a tribute to minimalism. It's based 
on the Atm el AVR ATtinyflS* which shares the same processor as your Arduino. The AT'tinyflS lives in an 
eight -pin piastlc DIP and needs only a few volts tn operate. rheTV-E-Gone circuit has only a single 
pushbutton input and two outputs. One of the outputs is connected to a high-current driver circuit that 
drives four infrared LEDs. The other output drives a visible green LED to let you know It's doing 
something when you press the button. 

These little blinking LEDs can either bring a tiny bit of peace and quiet to your immediate vicinity, 
or they can get you barred from attending the Consumer Electronics Show 1 for life. True story. 

Think about that the next time you hear a comment about Arduinos only being good for blinking 
LEDs. 


184 



CHAPTER 3 EXAMPLE PHQJECTS 


A Lot of Blinking LEDs 

An Ardulno Uno can Light up about 20 LEDs individually, hi the absence nfa driver circuit, as many 
LCDs as you want can lie driven directly by die Arduino's 3 1 0 pins, as long as the coral power drawn 
remains less than 2lK)mA. This can be guaranteed by limiting the current to each LED to 1.0mA or less, 
nr hy limiting the duty cycle of the LEDs in software so that no more than 20QrnA is drawn at any 
given time. 


A Direct-Drive Example 

Mere is a simple circuit that connects 20 LEDs in the form of a har graph, implemented as air Arduino 
shield. See Figure fi- III for the schematic and Figure B-ll for art example PCB layout. 


PK- |lT-PJI > 


PDi li;Tx > - 
PD2 \2 > 

PCS |3- > 


RT 01 

AAA/ — H- 

R2 02 



PC2 [aT~> 


PCI Ga > - 


pci ,u 


pcs las > - 


1 1, me 

Wv W- 

fllT 0l7 

A A A — W- 

=6in me 

-N- 
-►I- 

: !lU D20 

AAA— 


sia 


Figure 9-10, The schematic diagram afthe 2Q-LED bar-graph shield 
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J3 PORT B J1 PORT D 



J.| POWER J2 PORT C 


Figure 3-11- The PC.B layout of the 20-LED bar-graph shield, showing only the solder side (bottom) 
connections. The cathodes of all the LEDs are connected to GND via a ground plane on the top side {not 
shown). 

This is a direct-drive configuration, meaning that each LED can he addressed directly. Each LED is 
connected to a single ].'() pin, which should he configured as an out put. 

This particular implementation also uses the USART serial input line as an output. Because the 
Arduinn Uno installs a couple of LKil resistors between the USB interface and the ATmega32fi, the lower 
impedance of the I/O pin's output driver wins, swinging the output fully from 3V to ground and turning 
on and off the LED under program control. 

This technique usurps the USART 's receiver pin, hut only temporarily. TheArduino can still he 
reprogrammed later using the Arduino software, because the first thing that happens during a sketch 
upload Is to reset the processor- this Invokes the on-board bootloader, which properly configures the 
USART For communication. The Arduino forgets ail about the misuse of the LJKART's serial input line as 
an output. 

There are two ways to go with Lhc resistor value selection. If you want to light up all the LEDs at 
once, you must restrict tire current to each LED to under 10mA. This will keep the total current under the 
200mA device maximum, which you have to respect when driving tire LEDs directly with the DO pins. 

For typical red LEDsoF normal brightness, use a minimum of330fl, 1/4W resistors for Rl-20. For 
other colors, you need to calculate the resistance using the Formula V k + I iM ., where Y k is the voltage 
dropped across the resistor (that is, V . - the LED's V h , or forward voltage) and I M M Js the current desired, 
in this ease, use 0.D1UA (10mA) for I |M1 . 
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If you anticipate only needing a few LEDs, on at any given time* yon can push more current through 
each of the LEDs by lowering the value of the current-limiting resistors used on the PCB. You must not 
exceed the 40 mA Limit for each I/O pin. 

A good method to enforce this self-imposed LED Until Is to use a single function In your sketch to 
control the LEDs. This keeps all the hardware rule-enforcing policies In one location, at the cost of being 
able to turn on or off LEDs randomly throughout the sketch. 

To fit ai] 20 LEDs It) a single Hate across Lite Ardulno shield, you use a smaller, rectangular LED 
measuring 2mm x 5mm x 7mm. Alternately, you could use a pair of ten-segment bar graph modules. 

The spacing of the pins would have to he Increased front A. 100" to 0.300" to accommodate the larger har- 
graph modules, but this makes it a lot easier to populate the PCB and keep all the LEDs aligned 
attractively. 

Not shown in the PCB layout Is the ground plane on the top Layer that connects all the ground 
connections together and wires them to the GND pins on hoth the POWER and PORT B expansion 
connectors. 

You spend some more time on PCB Layout tools and techniques in Chapter 10. 


Direct -Drive with LED Drivers 

Why do you have to choose between many LEDs and bright LEDs? You don't; you can have both. AH It 
takes is a few LED driver circuits between the ATmega and the LEDs. 

Wiring 2ft individual driver circuits Is possible but may become tedious, especially if more than one 
assembly is being huilt. A low-cost alternative Is to use a pre built transistor driver chip, such as the 
ULN2003. It contains seven transistor driver circuits. Each driver contains two NPN BIT transistors 
configured In a Darlington arrangement. The output of the first transistor drives the base of the second 
transistor, thereby amplifying the current even more. Sec Figure ?5- 1 2. 


D3- 



Figure 4S-ILH. Each of the driver circuits in the IILN2003 contains a Darlington pair of transistors anti 
associated resistors. 

You can use three of these chips to drive up to 2 1 LEDs. Lo keeping with the spirit of using 
component arrays instead of discrete components, you can also use two LED bar-graph modules lien 
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LEDs each) and three nesfsror networks* each containing seven resistors, with one common terminal 
connected to 5V. This reduces your component count [not counting connectors or rite PCB) to only 
eight. See Figure B- IS. 
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Pigure a- 1 3. Driving 20 LEDs directly using ihe ULN2QQ3 driver chip 


Multiplexing Techniques 

So far you've limited lire LED count to one LED per I/O pin. This Is fine when you have lots of I/O phis, 
such as the Arduino Mega 2560. Rut sometimes even the available 1TO pins of the ATmega256G chip 
(70 of which are available on connectors on the Arduino Mega 2560) Isn't enough. In those cases, you 
have two alternatives. 

The first alternative is to use additional hardware ro expand the number of available I/O lines. This 
is certainly a viable choice when a large number of individual LEDs need to be controlled. One example 
is the use of shift registers, a type of dedicated hardware logic that allows a serial stream of data bits to be 
shifted through a hank of single-bit memories called flip pops. 
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The Arduino library supports the shiftOutf ) function, which serializes eight bits of data out on a 
single data pin and an associated clock pin. This works perfectly with one or more shift registers. An 
excellent tutorial on using both the shiftOutf ) library function and the 74HC596 shift register chip is 
available on the Arduino web site: http://arduino,cc./eri/Tutorial/5hift[)ut. 

Another technique for Increasing the number of LEDs is multiplexing There are several types of 
multiplexing that allow larger numbers of LEDs to be controlled by a circuit. Let's look at a few of the 
more popular multiplexing techniques. 


Row-Column Multiplexing 

One example is roto-column multiplexing. A rectangular array of LEDs is wired In a grid, with all of the 
LED anodes (positive terminals] connected to the grid rones and Lhe LED cathodes (negative terminals) 
connected to the grid columns. This example is called an anode-rote grid, to indicate which type of 
terminal (anode or cathode) Is attached to which dimension (row or column]. The rows and columns 
can be switched around, if necessary. See Figure fi-14. 



Figure B-J4. An anoeie-row LED array, illustrating row -column multiplexing 
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There are 5 columns and 7 rows of LEDs In this example matrix, fora total of 35 LEDs. This is 
enough LEDs to represent the uppercase letters, numerals, and punctuation of the English language, for 
the most part. Smaller and larger representations are also possible, but this Is a good place.- to start. 

it doesn't take many I/O lines to control this array: 5 for the columns and 7 for the rows, for a total of 
12. Twelve is better than 35, especially when you're talking about a precious commodity like 
programmable I/O lines on an Arduino. That leaves a few I/O lines left over on the Arduino Uno to 
interface with other circuits. 

Previously, you used direct control of each LED by connecting one terminal of the LED to its very 
own I/O line or LED driver. The other terminal of the LED was wired to either 5Vor ground, depending 
o n t h e cl reul L config u ra t lo n . 

Now you control each of the LEDs In the matrix by manipulating the underlying grid. As before, you 
tighi up each LED by connecting a higher potential (voltage) on tEie anode and a lower potential on the 
cathode. This results in current Tow though the LED, causing It to emit light. Just as before, you also 
need to make provision for some sort of current-limiting device to be in series with the LED to control 
ih e am o u n i of c u rr ent flo w ing, as wel l a s be m In dfu I of t lie c u rrent - h and! Lng capa b Hit ies a f each 1 / O 
line. 

To illustrate the basic idea of row-column multiplexing, let's omit the current constraints from the 
simpllfied model matrix and concentrate on the fundamental techniques. You go hack and add the 
appropriate real-world circuitry later. 

To light up a single LED in this array, you first identify which row and column uniquely addresses it. 
Let's use the numbering scheme 111 u si rated in Figure fi- 14, with rows numbered 1-7 from top to bottom 
and columns numbered 1-5 from lefl to righi. The top, left LED then has row -column coordinates 1,1, or 
row 1. column L 

Assuming Arduino I/O lines are connected to all the rows and columns, you first place all the pins In 
a high impedance state by making them Inputs with no pull-up resistors active. This happens to be the 
default stale of all Arduino I/O lines; but let’s not assume things are the way you want them, and specify 
how things should be. See Listing fl-7. 

lilting 3- 1. Blinking cl Single LID in a 5 * 7 LED Array 

const byte rou_plns[7] ={1,1, 4, S t 6, 7, & }j 
const byte column_pins[5 1 = { 9, lOj, ii* 12, 13 Is 

void leds_off ( ) { 

byte i; 

// reset all row pins 
for(i = 0; i < 7; i++) { 

digitalWrite{row_plns [ i] > LOW}; // turn off ro* pin 

pinHode(row_pins[i], INPUT); ii make row pin high- impedance 

> 

U reset all column pins 
for(i = 0; 1 < 5; i++) { 

digltalWrlte{coIumn_pins[l], LOW); ii turn off column pin 

pinHndc(colu«n_pins[ i] , INPUT}; // make column pin high- impedance 

> 
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void one_led(byte row, byte column) { 
row-*; 
column--; 

Icds_off(); ti turn off all the LEDs 
pinnode{row_iJins[row], OUTPUT); // turn on row pi n 
digitaIhrite(row_pins[row] „ HIGH); fi rows = anodes = high 
pirtMode{column_pins[colu«n] ,. OUTPUT); U turn on column pin 
digitalWrile£column_|iins [column] , LOW); ii columns - cathodes = low 

} 

void setupO { 

} 

void loopQ { 
one_ledti j! l); 
delay ( idoo); 

Ieds_off(); 
delay ( 1000); 

} 

Nothing interesting happens in the setup() function, but it's required, so there it is. The loop() 
function calls another function, one_ledO. with tire coordinates of the single LED you want illuminated. 
Jn this ease, lt r s row l r column I. 

The first thing that theone_led{) function does is adjust the two parameters row and column to be 
zero-based instead of one- based- People -types lend to number things starting at one [one- based), but 
computers, well, they like to start at zero. You're calling tire upper-left corner of the LED matrix row i, 
coiumn l. The two lookup tables used for translating the row and column designators to Arduino pin 
numbers — row_plns! ] and eolu#n_pins [ ], respectively — are zero-based arrays. Tire Arduino pin number 
for row l is stored in row_pins[o], and the pin number for column J is stored in tolu.*n_pins[G]. So each 
of these parameters is decremented by one before proceeding on to the rest of tire function. 

Next, the ene_Led[) function eatls yet another function, leds_off{). As Us name might suggest, this 
function turns off all the LEDs in the array by flipping the direction hits of all the I/O lines being used to 
address the LED matrix into inputs. It also turns off any pull-up resistors that may have been previously 
activated. This effectively shuts off all current flowing through the LED array, rendering it dark. 

Now that the onc_led() function has specified its starting conditions, it can turn on a single LED in 
the matrix by programming a single row pin and a single column pin to be outputs and setting their logic 
levels appropriately. For anode-row LED matrices such as the example in Figure fl-14, you set the anode 
HIGH using the digltalwritef) function, and the cathode LOW. For the other flavor of LED matrices 
(anode-column or row-cathode, however you want to call them], reverse those two levels to allow the 
current to flow in the more interesting direction. Remember, LEDs are diodes and conduct current in 
only one direction. 

The Ioop(] function blinks this one LED In the corner by alternately calling theone_led() function 
and the leds_off ( ) function. Interleaved with a one- second delay to make the hi ink more visible. 

To let all those other LEDs have a turn, replace theloopO function with the following code: 

void loop{) { 

byte row* column; 

for(row = i; row i- r; rowt+) { 

for (coiumn = a; column c= 5; co!umn++) { 
one_Ied(row J column); 
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del ay (ICO); 

} 

} 

1 


This creates, a walking-dot pattern, with a single pixel scanning across each row and then down to 
the next row, repeating when It reaches the bottom of the LED matrix. 

As fascinating is this display Is at this point, it still doesn't spell out A for Ardutno (our goat]. To do 
this, yon have to resort to trickery. 

It may or may not be obvious from the schematic alone, but It Isn't possible to control every LED 
individually in this array. Yes, it’s possible in turn on any one LED, but only as iong as all the other LEDs 
are off. Using the simplistic row-column addressing. If you turn on the LED in the upper-left corner (L, l) 
and also want to turn on the LED in the lower- right corner (7, S] at the same time, you may be surprised 
by the mysterious Illumination coming from the other twn corners. Then again, you may not. 

The current applied to the grid flows through every possible combination of rows and columns. The 
best you can do Is to enable a single column at a time and light up only the LEDs in that column by 
turning on their respective rows. Then the next column can he illuminated, then the next, and so on. If 
this process Is repeated fast enough, It looks like a solid pattern of LEDs. 

It's also possible to scan through the rows, enabling the Individual columns. You want to keep the 
update rate as fast as possible while doing the least work. Because this example array has fewer columns 
than rows, It takes Less time to scan through the columns. 

Listing S-B contains a sketch that displays a capital letter Aon a 5 * 7 LED matrix, this time using a 
col u m n-a no d e, row-ca t b od e m odule . 


Lisring 3-S. Displaying A forArdufno on a 5x7 LED Matrix Using Row-Column Multiplexing 

const byte row pins[r] = { 2* 3, 4, 5, b, 7, & b 
const byte eolumn_pins[5 ) = { 9, lOj, li, 12, 13 }; 

void setupO { 

byte i; 

for(i = 0 ; I < 7; i++) { 
digltaLwrite{row_pins [ ij , LOW) ; 
pinHode(row_pins[i] , OUTPUT); 

} 


for(I = 0; i < Si i++) { 

digit a Iwrlt e( co iumti_pi n s j[ i ] , LOW ) ; 
pinMode(coluan_pi.ns[i] , OUTPUT); 

> 

} 


void draw_ column (byte bits) { 


digital¥rite(£Qw_pins[o] , bits 
digit alWrite£EOw_pins[l] , bits 
digit alwrlte(Et)w_pins[2 j , bits 
digitalhrite(rDn_pins[ 3 ] , bits 
digitalWrite(row_pins[4] , bits 


0X40 ? LOW t HIGH); 
0X20 ? LOW ; HIGH); 
0x10 ? LOW t HIGH); 
0x0* ? LOW : HIGH); 
0x04 ? LOW i HIGH); 
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digit alwr ile(row_pins[5] , bits ^ 0x02 ? LOW t HIGH); 
digitalWrite[E0w_piiis[6] , bits & 0x01 ? LOW t HIGH); 

} 


const byte bitmap [5] - { 
oboooiiiii, 
obooiooioo, 
oboioooioo, 
obooiooioo, 

ObOOQlllll 

h 


void loop() { 
by to column ; 

■for (column = 0; column < 5; toluan++) { 

ciigitalWi'ite{column_pins(coluan] j, HIGH); // enable this column 

di a w_co lumn [ b i tmap [column]); 

delay (2); 

digitalWiite[columii_pins[coluan] > LOW} ; // disable this column 

> 

} 

The sctup[) function turns all the necessary I/O pins into outputs and then sets their outputs to a 
LOW level. The loopf) function Iterates through the five columns, enabling only one column at a tbne. 

The actual dots are drawn in the draw_column() function, which Is passed a slice of the letter’s pixels 
from the bitmap! J array. Each bitin the column is examined, and if it's supposed to be on. It’s turned on 
(by setting the corresponding row pin LOW); otherwise it's turned off. 

TheC ? operator tests a conditional statement and returns either the first yalue (LOW in this example) 
if the condition is true or the second value (HIGH in this example) after the colon if the condition is 
false. This is more compact than writing a bunch of if( condition) , . . statements. 

You can just see the outline of the character to be drawn If you look at the bit«ap[ J array's 
declaration sideways. The ones represent lit pixels, and the zeros represent dark pixels. Can you see it? 
The Ob. . . notation allows a binary number to he written as a series of ones and zeros, which makes it 
easier to see bitmapped patterns. 

The short delayO In the loop Is required. If omitted, column ghosting will occur, where LED pixels 
seem to bleed over from one column to another. This is caused by not giving the I/O lines enough time 
to change states. The additional delay gives the I/O lines time to properly synchronize and eliminates 
ghosting. Try It without the delay () function to see what it looks like, If you're curious. 

This sketch works, after a fashion, with only seven current-limiting resistors between the Ardulno 
I/O pi ns and the row pins of the matrix. The column pins can be connected directly to the Ardulno pins. 
The display isn't very bright, however. See Figure B-15. 
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Figure d (-15- AS x 7 LED matrix driven by the Ardulno pins, without column drivers. A is for Ardulno. 

This is caused by two Important factors. The first is that all [he current to drive an entire column of 
LEDs Is being switched on and off by a single I/O pin. Remember that an Ardulno’s I/O lines are only 
supposed to handle up to 40mA of current. You can augment this current-handling bottleneck by adding 
a column-driver circuit. Remember to change the logic of your sketch If you add an inverting driver to 
the circuit. 

The second factor is that the duty cycle of each column Is only one In five, if the LCD is supposed to 
be on, JTs really on only 20% of the time, meaning It's dark 00% of the time. Once you Ve got your 
matrix-scanning sketch working properly, feel free to increase the current through each LCD. It’s only 
the average current over time that counts. 

Extending this project requires more LCDs, more I/O pins (or additional hardware) „ and certainly 
more sophisticated software, unless your communication needs arc satisfied with a single capital A or 
single LEDs. Tiny Pong, anyone? 

Also available are precon figured arrays oF LEDs, complete with semi-intelligent controllers. Figure 
ft- 1 ft (top) shows a 32 ^ 1ft LED module from Sure Electronics in China. It's powered by SVand has four 
Ifnltek HT1632 driver chips installed. Each pixel has both a red and a green LED installed. This allows for 
four possible color combinations: red, green, yellow, arid black. More information about how to connect 
it to your Ardulno can be found In the Ardulno Playground: wHM.arduino.ee/playgrourid/ftain/flTlg32C. 
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But wait, there's more! Why atop at two -dimensional LEDs when you can gn ftD? See Figure ft- 1 ft 
(bottom). 



*9*003 3 so 3 ji 

«a<i*«*40«aa«eaaf9joaa^3 ? j 

. .9»f0^4o9 a -a 

tiiftttff t<aflaA4aa9a0449949 

04**4*4444044400**00000009 

cgiiiiaaaasfltia9ioi0 9 9 i 99344 

oogso-oocoo 00*0000 
tl«tt9«Dee0a40S0939994;)9) J 
*444440449400 0 OQOiJOOOOO 
4# 9 444004044*49090 00000099 
4*4444440 0004444490040000 9 
#4004e404OOO4OO44OOOOOO 9O j 
900444094 4 0000400 0 00000 

4 44 4 4 4 4 444 444 4 94 0 0# 4 40 0 44 O 



Figure 8-1 h- ^ ,'12 * 16 bieolor (red + green} LED array with embedded drivers from Sure Electronics (top) 
and the 3D 4 *4x4 RGB LED Cube kit from Seeed Studio (bottom). 


This beautiful sculpture in Figure ft- IS uses 64 LEDs, each one containing a red, green, and. blue 
LCD die. 
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Segment-Digit Multiplexing 

You don't need 35 LEDs to displays message if your message is composed entirely of numerals. You can 
represent the Latin numerals 0-9 using jusi seven carefully arranged LLDs. See Figure fl-17. 



Figure 8-17- A seven -segment LED array can represent the numerals from 0-3, and a few letters, too. An 
eighth LED forms a right-hand deelmaf point. 

The LED segments of the numeric display are labeled a through. g h starting at the top and going 
clockwise, and ending with the middle segment. Arrays such as this one are usually configured with 
either all the LLD anodes or ail the cathodes wired in common, and referred to as either common 
anode at common cathode. A com nr on -cathode seven -segment LED module is shown schematically 
in Figure ft- IS. 
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.Figure 3-j!E- rjtotf sdi4?mnf/c diagram o/a CQMmflM-ciitfiQde,. LED module* with right-hand 

decimal point 


A single numeric dlgil can count from zero to nine. It can also display a limited number of letters 
and jinnct nation. See Listing B-9. 


Listing 3-9. Demonstration Sketch far a Single Seven -Segment LED Display and a Pushbutton 

G define PUSH &UTf O^J lN^LlT S 

Sdefine SEGMENT_A 6 
fldefine SECMENT_B 7 
Sdeflne EEGMENT_C B 
fidcfine SEGMENT_D 9 
Gdefine SEGMENT_E 10 
Sdcfine SEGMENT F il 
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fifdeflne SECMENT_G 12 
Sdeflne SEGHENT_I>P 

void set up{ void) { 

// push button input 

pinMoiie(PUSH_&imON INPUT, INPUT}; fi this is an input 
digitalWrite(PUE.H_BuTTON_INPuT, HIGH); U enable built-in puLl-up resistor 

// turn off dll LED outputs 

digital¥rite(SEGMENT_A 3 LOW) ; 
digltalwrite(SEGMENT_& 3 LOW) ; 
digitalHritefSEGMENTC, LOW); 
d igitalUr ite ( SEGM.ENT_D , LOW); 
digitaltfrite(SEGMENT_E 3 LOW); 
digital¥rite(SEGMENT_f , LOW); 
d igitalWr ite ( SEGMENT G, LOW); 
digitalwitef SEGMENT DP, LOW ) \ 

ft LED segments are ill outputs 

pinMode(SEGMENT A, OUTPUT); 
pinMode(SEGMEN!~B, OUTPUT); 
p irliMod e { S EGME NT_C , OUTPUT); 
p inMod e { S ECME NT ”u , OUTPUT); 
pinMode (SEGMENT _E, OUTPUT); 
p InMed e { S EGME NT_F , OUTPUT) ; 
pinMode (SEGMENT G, OUTPUT); 
p InMod e { S EGME MT_D P , OUTPUT); 

} 

// buttonPrcss( ) fu net Lon returns TRUE if button is pressed, FALSE otherwise 

ffdcfine TRIE i 
Pdefine FALSE D 

int but tonPr ess (void) { 

if (digitalftead (PUSH_BUTTGW_INPUT } == LOW) { 
return TRUE; 

} else { 
return f-ALSE; 

> 

) 

ft LEDnu«ber() displays a single digit on the 7-stg»cnt LED display, 0-9 

const byte L£Dseg*ent[] = { 

// GEE DC BA 
ObOOllllii, ft & 
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ObOOOOOllO, it 1 
ObOlQllDll, H 1 

oboioomi, it 3 

ObOllOOllO, it 4 

cboiioiioi, n s 
obaiiiiioi* a 6 
oboooooiii, it i 
oboiiiim, it k 
obonoiiii, it 9 
h 

void LEDnumber£lnt number) { 
unsigned char i; 
if(number < 0) { 

forfi = SEGMENT_A; i <= EEGMENT_G; 1++) digital«rife(i J1 LOW) ; it turn off all segaents 
} else { 

d iglt a iHr It e{ E EGM E NT_A , LEDs egrtent[ number] & OxOi) ; ft segment A 

digltalWrite{!iECMENT_B, LEBseg*ent[ number] & 0x02) ; // segment B 

digit a lHrile{ S EGMENT^ L£Dsegaont[ number ] & 0x04); it segment t 

digitalWiite{SECnENT_D' J LEDs egaent| number J & 0*08); it segment D 

digltalWilte[EEGflENT_E, LEDsegaont[ number] & OxlO); // segment E 

digitalWriteEEEGMENT_F f L£Dseg«nt[ number] & 0x20); it segment F 

digltalWrit&tSEGMENTjG, LEDseg*ent[number] S 0x40); ft segment C 

> 

> 

Sdeflne DELAY_T1ME too it 100 milliseconds =0,1 seconds 
void loop (void) { 
unsigned char x = 0; 

If (buttonPresst)) { 

digitalWiiteESEGMENT-DP* HIGH); // turn on decimal point if button is pressed 

> else { 

digit a lWrlt e{ S EGM£NT_DP f LOW); // else turn it off 

> 

LEDnumber(O); // display a 0 
delay (DELA¥_T1ME); //a short delay 
LEDnumber(i); // display a l 
delay (DELAYTIHE); // a short delay 
LEDnumber(2); // display a l 
delay(DELAY_TIHE); // a short delay 
LEDnumber(l); // display a 3 
delay £ DE LAY_T IME ) ; it a short delay 
LEDnumber(4); it display a 4 
delayf DELAY_TIHE) ; // a short delay 
LEDnumber(s); it display a 5 
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delay (I>ELAY_T1HE); it a short delay 
LEDnumber(6); // display a 6 
delay (DELAY_T3HE) ; it a short delay 
LEDrtumber( 7) ; // display a J 
delay £&ELAY_TIHE); // a short delay 
LEDnumber(i) ; it display a & 
delay (DELAYJTME) ; // a short delay 
LEDnumber(9); it display a 9 
delay (DELAY TIME); it a short delay 

LEDnumber(-t)j; // clear the LED display 

// now loop here forever S ever 

while (l) { 

while (button Press() == FALSE); U wait here for button te be pressed 
while (butt&nPressO == TRUE); // wait here for button to be released 

LEDnuaber(>t) ; 
x++; 

if(x >= 10 } x * Oj U start back over at zero 
delay (DELAYJ1HE); 

> 


This sketch starts out with some pin assignments in the form of several ff define statements. Eacli 
segment, including the decimal point, Is assigned to an individual 3/0 pin. 

A momentary-contact pushbutton is connected between pin 5 and ground. The built-in pull-up 
resistor on pin 5 is enabled so that when the button isn't being pressed, the input p Ln s logical level is 
HIGH. When lire button is pressed, the input pin Js shorted to ground, and the Input pins reads as a LOW. 

A function called but tenures sQ encapsulates this button Logic, returning a RUE value when the 
button is being pressed and a FALSE value when it isn't being pressed. This allows you to test the button's 
state using (semi-) intuitive statements such as if (buttonPressO) 

The segment patterns for the numeric digits 9-9 arc encoded in a const byte array called 
LEDsegment[ J. 

Another function defined in the sketch is LEDnuaber( ), which takes a single parameter. If the 
parameter is negative, the LCD display Is blanked. Otherwise, [be parameter is used as an index to ibe 
LEDsegment[ J array, and Lite Jn dividual bits are tested to determ Lite if l lie I/O lines should be set to a HIGH 
or LOW value, either turning on or turning off the respective segment. 

The loopf) function counts from f) to 9 on the display and then goes into ait infinite whllo() loop, 
w ail ing for -he ljsve lo p:vih :imIUml. lime llie billion pressed, (and released}, Lhc numlua on the 

LCD display is Incremented, starting back over at zero once the number exceeds nine. 

Two digits can count from 0 to 99. This would be good fora seconds counter, for example. A two- 
digit, seven-segment display can be wired directly because it requires only 14 (2 * 7) LCD drivers, which 
can heArduino I/O pins. 

You can control more digits with fewer I/O lines by using a variation of the row-column 
multiplexing technique. The individual segment Sines are connected together [that Is, all tire a segments 
bussed together, alt the b segments together, and so on), and the common Lines — either common-anode 
or common-cathode— can be used to enable the individual modules. See Figure S- 1 9. 
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J uni Like the row-column multi plexing you did previously, there are two ways to scan a seven- 
segment LED display Like tills one. The first, and perhaps the more obvious approach, is 10 enable one 
digit at a time and then light up only those segments that belong to that digit. If repeated fast enough, all 
the digits appear to he illuminated simultaneously. Trickery! it serves you well,. 

Alternately, the opposite approach is to enable each of the segment lines individually and then drive 
ail of the digits that currently want to display that segment. 

A third approach, and one more suited for battery-powered applications such as digital watches, Is 
to Illuminate only one segment a; a time. This works better than you might first imagine. It's the 
technique used on the delightful Solder : Time watch by SpLkenzJeLabs. See Figure fl-20. 



Figure S~20. The Solder: Time watch kit from SpikenzleLabs turns on only one segment at a time to 
conserve battery power , while still presenting a very readable LED display. 
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Time-Domain Multiplexing (Persistence of Vision) 

Another form of multiplexing substitutes one of the physical dimensions of the display with the time 
axis. This Is properly called time-domain multiplexing, hut you may know it by the more popular phrase 
persistence of vision. 

Fora basic persistence of vision (POV] display, only a single row of LEDs Is required. The 131 inky PQV 
kit by Wayne and Layne is a perfect example. See Figure 6-2 ] . 



Figure &-2i. The Blinky POVkit Is a simple persistence of vision LED circuit that is available In kit form 
from Wayne mut Layne (http://wayneottiilayne.coa ). Photo by Wayne and Layne. Used with permission. 

The single row of LEDs flashes out a pattern of dots. Wave the unit around, and your eyes stitch 
together the dots to form a two -dimensional Image. See Figure 6-22. 
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I# BLINKV prj 


Figure Wayne unit Lay ne's Blfnky POV kit in action. Photo by Wayne and Layne. Used with 

permission. 

POV applied [Lons require maximum brightness from tlie LEDs. because their output is spread olh 
over a Larger area than normal Make sure you gave your POV LEDs ail the power they eaat handle. 


GharliepJexing 

Meed to light up a tot of LEDs hut can't spare a lotofl^O lines? Charlleplexing may be the answer. 


The LoL Shield 

Jimmie P. Rodgers is an Inventor, speaker, and teacher. Like Mitch Altman (and often with Mitch 
Altman), he travels the world, checking out crazy stuff and teaching people to solder and make things. 

One of the things Umniie makes (and sells) is the LoL Shield. J.oL stands for Lots of LEDs. It's 
basically an experiment to see how many 3mm LEDs eat) fit on a standard Arduino shield. The answer to 
that question Is: 126. See Figure 6-23. 
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Figure S-2-j. The LoL (Lots of LEDs) Shield by ffmmie P. Rodgers: a chariieplexed LED array in the farm of 
an Arduitto sheild 

At first glance, you might assume some sort of multiplexing was going on hem, and you'd be right. 
But co u it t again: that's a 0 x 14 rectangular 1 matrix. It would take.-*! + 14 (23 ) I/O Lines to wire that up 
using row-column multiplexing. There are no hidden shift registers underneath, either, h uses a 
different type of multiplexing that is almost unique to LEDs: charlleplexlng. 

Chari Leplexlng was mentioned in application note I0BO from .Maxim 1C (www . nurd#- £e . cn-?/ de- 
notes/ in dex.rnvp/id/iBisoi published February lb, 2001. Chartie Allen was mentioned as an early 
promoter of this technique to drive LEDs and save I/O pins, hence Lite name. Maxim 1C also 
manufactures several LED driver chips that Implement this technique in hardware. Earlier, in August 
2001, Don Lancaster described this technique in his Tech M usings column 

tin a ja.com/glifci/rtiusel52.pdfS', but be credits Microchip Technology with the idea. Mr. Lancaster, 
the inventor of the original color organ and author of dozens of technical books, describes char! Leplexlng 
as a problem in ^-connectedness and compares it to string art. 

Microchip published an application note titled “Complementary LED Drive" by lean- Claude Hchic 
(httpr/Zwwl.m icroc hip. com/ d own load s / e n /AppNo t e s /9 lt>2 9 a . pdf j in L fi SB. 

Chari Leplexlng takes advantage of the both Lite trl-staie capabilities of modern microcontroller I/O 
lines and the single-direction current-flow characteristics f polarization) of LEDs. The topology of 
charlieplexed LED displays is unique. An attempt at a simple explanation follows. 

If you have three I/O lines available, how many LEDs can you uniquely address? Using a direct -drive 
approach, you can get up to three LEDs going. Using a row-column arrangement, only two (a 2 x 1 
array!. 

Using Charlie plexing, you can gel six. I low? By connecting an LCD between every available I/O line 
and then connecting another LED backward between the same I/O lines. This gives you n x (n - l) 
possible LEDs, where n is the number of I/O lines you can allocate to the LED display. The LoL Shield 
uses 12 I/O lines. See Figure 0-24, 
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j%ftre &-24- The schematic of the LoL Shield by Jimmie P. Rodgers 

This is version 1.0 of the LoL Shield. The current version corrects a small ghosting problem caused 
hy the preinstalled LED on Dlfi that comes with most modern Arduinos. You can, alternatively,, remove 
either the LED or I is associated current-limiting resistor 10 avoid the ghosting problem. 

So here you have lift [of a possible 132) LEDs controlled by only 12 L'O lines. Amazing] 


A Digital Clock 

First, a disclaimer: This is nor a very good digital clock. It's the beginning of a really nice digital clock 
project, but only that: a beginning. Let's look at what it does and bow it does It. Then you can think 
about possible (mandatory?) upgrades and some of the ways you might want to implement them. 

Building a good digital clock is a hit outside the scope of this chapter. But after working on this 
project, you should have a good idea of what would he involved in taking this project to the next level, 
should you desire to do so. If not, please feel free to skip to the next chapter. 

Figure SJ-25 lathe schematic of the clock. It's drawn as an Arduino shield, hut unless your dighat 
clock needs an USB interface, Lt maybe easier to drop a processor and related support circuitry onto this 
circuit and have a stand-alone clock. 
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ArduLno pins 2-5 provide the digit-driver signals. The PNP BJTs, Q 1-Q4, switch [he common anodes 
of the MAN61 10 dual? segment LED display modules to V. when their bases are driven low. This is the 
opposite behavior [hat you saw with the other polarity, NP.N, in previous driver circuits. 

ArduLno pins 6-13 drive the segments directly, with current- limiting resistors in series. Because the 
segments of the module are the cathodes of the LEDs inside, the vo Stage presented on the Arduino pin 
must be low to turn on the segment. 

Each of the MAN6110 modules has two complete seven-segment arrays with right-hand decimal 
points. The pins on the module aren't bussed together. What may not he obvious from the schematic is 
that the right-hand module is rotated Uil)* so that its decimal points are on the top side Instead of the 
bottom. The wiring of the segments accommodates this rotation. This was done to create a colon 
between the two center digits. See Figure 
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Figure S- 25 . The digital clock prototype built on a solder less breadboard 
Listing ft - 1 0 shows the sketch for the prototype digital clock. 

Listing B-JO. Outline for a Digital Clock Sketch 

volatile byte seconds_unlts = o; 
volatile byte seconds_tens = 0; 
volatile byte minutes_units = 0; 
volatile byte minutes_tens = 0; 
volatile byte hours_units = 2; 
volatile byte hours_tens = i; 

const byte numerals! to] = { 


‘obooiiim* 

// 

0 

''ObOOQOOllO, 

it 

i 

'ObOlGllOli, 

it 

2 

'ObOlDOllll, 

it 

1 

'ObOilMilOj 

it 

4 

'oboiioaioi. 

it 

5 

'■oboiiiiioi^ 

it 

6 

"GbQOQOOlii, 

it 

7 

"Ghoniim, 

it 

S 

"0l>01101lll ± 

it 

9 


}; 

void setupO { 

it digit drivers « active low 
plnModeta, OUTPUT); It digit i - right 
pinMede{l> OUTPUT); // digit 1 
pinnode{4* OUTPUT); it digit 3 
pinHode{5> OUTPUT) ; It digit 4 - left 

it segments - active lew 
piiinede{6 J OUTPUT); // segment a 
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pinMode{7> OUTPUT); fl segment b 

pinMode[6, OUTPUT); ii segment c 

pinMode^j, OUTPUT); ti segment d 

pinMode{iQ, OUTPUT); ti segment e 

pinMode{n, GUI PUT); it segment f 

pinModetii* OUTPUT); it segment g 

pinModetU, OUTPUT); it segment DP* also Arduino LED 

// turn LEDs "off" 

d igital Write (S.j HIGH); it digit 1 off 
digitalttrlte(3j HIGH); // digit l off 
digit alHrlte(4j HIGH); // digit 3 off 
digit alWritefSj HIGH); // digit 4 off 

// sot up i second interrupt on Timer./ counterl 
TCtlilA = 0; 

TCCfelB = K<H&H13 | K<WGMl2 | | 14<CS10; // clock = E_CPU / 1024 = 15625 Hz 

ICfti = 15625; 

bitSet[TIHSRi, iCIEi); // enable capture event interrupt 

// set up ^240Hz Interrupt on Tiaer /Counter 2 
TCttoA = o; 

TCCK2& = 6; it select CK/256 

bitSet(TlMSR2, TOlEl); // enable overflow interrupt 

} 

void loop{) { 

ff nothing happens here! 

} 

void drawSegment(byte index) { 
digit alKfrileffr, numerals [index] B OxOi); // segment a 

digital Write( 7 j numerals [ index] B 0x02); U segment b 

digltalWriteCa^ numerals [ index] B 0x04); // segment c 

digitalwrite[9, numerals [ index j B 0x04); if segment d 

d£gltalWrite[10, numerals] index] & OxiO); if segment e 

digltalwrilefllj numerals! index] 8 0x20); // segment f 

digltalhrite(l2 , numeral s [ index j 3 0x40); ff segment g 

1 

ISS ( T IME R i_CAPT_vect ) { 

ff keep time: this Interrupt should happen once every second 

second s_units+*; // count seconds x i 
if (seconds_units y j) { 
seconds_units = 0; it reset seconds x 1 
seconds_tens**; // count seconds x 10 
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if £seccnds_tens > 5) { 
seconds_tens = 0; // reset seconds * id 
minutes_onits++; // count minutes * l 
if)>inutes_units > 9> { 

«inutes_units = 0; // reset minutes x i 
minutes _tens++; // count minutes x 10 
if (minutes_tens > S) { 
minutes_tens = 0; // reset minutes x iO 
hours _un it s++; // count hours x l 
if (hours_units > 9) -{ 
foours_units = 0; // reset hours x i 
hours_tens++; // count hours x 10 

> 

if ((hours_units == }) IB (hourstens == l>) { 
hours_units = l; 
hourstens = 0; 

> 

} 

} 

} 

> 

} 

I $ R ( TIME R 2_G VF_ v#ct ) { 

// tell time: this interrupt should happen 240 times a second 

static byte digit = 0; 

// turn on the correct digit 0-3 

switch(digit) { 
case 0: 

digitalWrite{13j. HIGH); ii turn off decimal point 
digitalWrite( Sj. HIGH); ii digit 4 off 
drawSegment [minutes_units) ; 
digitalWrite( 2j. LOW); // digit l on 
break; 
case is 

digitalwrite(i3, tOW); // turn on decimal point 
digitalwrite(2, HIGH); // digit i off 
drawSegment (minutes_tens) ; 
dlgitalWrite(3j, LOW) ; // digit 2 on 
break; 
case 2s 

dlgitaLWrite(ij, LOW); ii turn on decimal point 
digitalWrite{3* HIGH); // digit 2 off 
dramSegment{hours_units) ; 
dlgitalwrite(4j, LOW}; U digit 3 on 
break; 
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case 3: 

digitaLWrlte( 13, HIGH); it turn off decimal point 
digitalis It £(4* HIGH}; it digit 2 off 
drawSegmtnt{ : houi , s_tehs) ; 
dlgitalHrite{5* LOW); // digit 3 on 
break; 

> 

digit +*; // move on to the next digit 
if (digit > 3) digit = 0; // roll over 

} 

Some global variables are declared at the beginning of the sketch. These represent the individual 
digits that are displayed on the clock. It's easier to increment and test these single-digit values than to try 
to extract them later using Integer division and hit masking. 

The bit patterns for the segments are stored In a const byte array called numerals! 1- Because the 
segments in the example clock elrcuh are active low, the segment binary values art: specified with a tilde 
('■) prefix, indicating they should he inverted by the compiler. This could be done with a single 
instruction In the function iliat actually writes the segment values out to the pins, but why? It r s constant 
data, and It's not going to change In the course of the sketch’s execution. There's no reason to code it 
wrong and have the Ardulno fix it at runtime. 

The setup!) function first initializes the direction of the output pin and then sets the digit-driver 
outputs HIGH to turn off all the LEDs at once. Remember that the signal Levels in this circuit are ail 
active low. 

The setup!) function then configures both Timer/Counter i and Timer/ Counter 2 to generate 
periodic interrupts. Timer •'Counter i is used to generate a I -second time base, using rhe Input Capture 
Event interrupt. Timer /Counter 2 provides a -2401 Iz Interrupt that schedules the multiplexing of the 
display digits. Each time through the Timer/Counter 2 overflow interrupt, one digit is decoded and 
displayed. This Is done by sending the numeric value to be displayed to the draw^egment() function, 
which looks up the correct hit pattern In the numerals!] array and sends It to the segment drivers. This 
ensures tliat the entire display is refreshed at SOHz. 

The actual timekeeping Is done in the Timer/ Counter I Input Capture Event Interrupt. Each of the 
hours, minutes, and seconds values is broken down into the tens and units (ones) digits and maintained 
separately. The seeonds_units variable is incremented each time iht: Interrupt is triggered. When it 
passes the value of nine, Jt r s reset, and the sec on ds_t.cn s value is incremented. This process cascades all 
the way through the timekeeping variables. 

A special case is invoked when the clock rolls over from 12:Srt to 1:00. It would be easier to code a 24- 
hour clock, where 12:00 means 12 hours past midnight and 00:00 means midnight. 

Notice that nothing at all happens in the loop!) function. Everything is interrupt -driven in lids 
example. This leaves lots of room to add new features, which are sorely needed. 

This example works, but just barely. It could be the beginning of a really nice clock project, as 
previously stated. Let's i:ikc a look at some of the areas ihat nec.-d more umrk. 


Accuracy 

The first thing wrong with this clock is that it doesn't do the one thing you most (or only) expect from a 
time piece: it [probably) doesn't keep very good lime. Its internal time base Is derived front the Ardulno 
system clock, which ls only as accurate as site component driving it. If you have an Ardulno that has a 
16MHz quartz, crystal, your clock is good for ±lOt)ppm (parts per million). This means. In real-world 
terms, that your clock will gain or lose as much as 4 minutes in a 30-day period. That's not exactly 
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horrible, but it’s not good, either. This number will vary with tempera lure and Lire age of the crystal, 
as well. 

If you have one of tire newer Arduinos, your processor could he clocked by a ceramic resonator. If 
that is the case, the overall accuracy of the system oscillator is only ±1%, meaning you can gain or lose 
over 7 /tours in the same 3 0-day period. Tins is certainly unacceptable in any real clock application. It's 
not even especially good for an egg timer. 

What other time base can be used? On the Arduino Mega 2560, an external fi2K3 1?, watch crystal can 
be attached to TOSC1 and TOSC2,and Timer/ Counter 2 can he clocked from it, asynchronously from 
the system clock. Even modestly priced watch crystals have much better tolerances than the typical 
quartz crystals used for microcontroller circuits. 

An external time base Is most definitely the way to go if long-term accuracy and stability are 
important design criteria in your next clock project. There are a wide variety of self-contained timer 
chips that can easily be added to your clock circuit. Some even Include leap -year-aware calendars and 
alarm functions. 

For the most accuracy for your money, you should look fora temperature-compensated crystal 
oscillator (TCXO). These circuits take into account a crystal's variance over temperature, which is the 
main source of error. 

The 601 Iz frequency of the main power grid In the OS and other countries (501 1 z elsewhere) Isn't 
accurate in the short term, but it's exceedingly accurate over a long period of time. Most commercial 
diglial clocks use this frequency standard to achieve timing accuracies that are better than one second 
per month. 

A circuit to measure the frequency of the Incoming power assumes access to AC voltages, which 
should be stepped down by a transformer first. The Arduino has a built-in voltage comparator available 
that you can use for the purpose, even generating an interrupt when the right time comes along. 

[f your Arduino Is still feeding off the power from your PC, why not send it a time signal from a time 
server on the Internet? This could be done once per hour or even once per day, allowing the Arduino to 
freewheel the rest of the time, relying on its own, admittedly Inaccurate time base in the between -times. 

You have a couple of other solutions to the time-base problem. In the US, the W\W system 
transmits a radio signal that repeats every minute. You need a special radio receiver to decode tills 
signal, hut they're available. Most GPS receivers have a high-accuracy timing signal available, but not all 
of them wire this signal to the outside where it’s easy to get at. You're looking fora 1PPS signal (one 
pulse per second] or something similar. 

Finally, If you really don't want to rely on someone else for your timing, consider setting up your 
own primary timing reference, also known as an atomic clock. Many older cell-phone towers had their 
own rubidium-based atomic clocks, and a lot of these are finding their way into the surplus markets to 
he bad fora mere fraction of their original cost. They generally require 24 V and about half an hour to 
warm up. but once they do. they 're spot on. 


User Interface 

There Is no provision in tills prototype for setting the time. This Is a glaring omission, unless you can 
conveniently plug it in ai either noon or midnight, in which ease you're covered. 

It might also be nice to momentarily look at the seconds portion of the time, or perhaps keep track 
of AM /PM or (gasp) maintain a calendar so ynu could know what day it was. All of these user interface 
functions could be handled using a . state machine to keep i rack of the current mode. 
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Additional Features 

An alarm function would he nice, as long as it's not mo alarming. This would also present a user- 
interface design challenge. You could either go old school and make Ji work just like every other digital 
clock Jn the world, or you could come up with something new and Interesting. 

A battery backup would he really useful, in the event of a power outage. You only get so many "my 
alarm dock didn't go off" excuses, you know. Most of the external timekeeping chips have provisions for 
battery backup, so maybe this Issue gets resolved when the time base Is upgraded. 

Real digital clocks, like the kind you huy at the store of £10 or less, automatically darken the LED 
display when the ambient Lighting lowers. Alight sensor can tell you how bright it is in the Immediate 
vicinity, bun bow are you going to dim the display? Although the wiring in this example was arbitrarily 
chosen to make it easy to draw and lo build on a breadboard, the sketch treats every wire as an 
individual and only wants to he told which wire goes where. There’s nothing that says the digit drivers 
can’t he connected to 4 of the 6 (or id) PWM outputs. Just remember that the digit drivers are aciiw foiv. 
Also remember that you've hijacked two of the three Internal timers that are used for the PWM outputs. 

A flashing colon might he a nice feature, or It might be plain annoying. Colons usually flash at 2Hz. 

I low can you generate ulUz signal within this sketch? You don’t actually have to do that, lust look at the 
value in the Tlmer/Counter 1 counter register and see If It’s past the half-way markon Its way to a full 
second. If that condition is met, turn on the colon. If not, turn it off. Mote that the example sketch turns 
on the colon within the display-update interrupt handler, hut only in the cases where the inner two 
digits arc being updated. 

So there’s your digital clock. Make something interesting out of It. 

Summary 

The Arduino and the LED: 3t"s a love story that not everyone gets. But some people get It. Do you? 

These are just a few of the many fun and exciting projects you can build, with an Arduino and very 
fit tie else. Let your creativity run wild, and he thinking of other cool LI1D projects that you can xvhip 
together over a weekend. 

But enough of these basic topics. Let’s get loro ihc really hard-core design and Implementation 
issues that you encounter with more complex projects. 

Don’t look directly at site LfiDs! 
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You thought it would he easy. You imagined a simple device that performed a simple function. How hard 
could it be? Well, now you know. It si at ted off simple enough, but you went and added feamres to it. 

This chapter deals with the aftermath of your project, as. well as some possible development issues 
should the project spill over to another programmer (or programmers), designers, makers, and users. 

You cover the vitally important topic of project documentation and how it can be of Immense use to you 
even before the beginning, as well as during development and after deployment. 

This chapter Is all about communication: not hits and bytes between chips, hut ideas and concepts 
between people. Every complex problem can be broken down into smaller, more Manageable problems. 
It’s the improved and enhanced management of these problems Lbat is addressed here. Better 
communication makes this task easier. 

You’re going to need some help along the way. Maybe you'll onEy need a little help. Like a suggestion 
about how to approach a problem, or the answer to a simple question. The good news is that you're not 
alone. Help is ready and waiting. A lot of excellent resources, mostly people, are here and willing to help. 
Learn about them, avail yourself tn them, and soon it will be your turn to share, to help someone else, 
and till are thereby enriched. 


Documentation 

Yon have several very effective weapons with which to combat the Increasing complexity of your design. 
The first and most effective weapon in your arsenal is documentation. Write It down. That's all it takes, h 
doesn’t have to be fancy nr even very detailed, hut it does need to be accurate and as complete as you 
can make Lt. 

Pretend that you’re actually still going to he interested in this project in three months and may want 
to go hack and understand “Just what was I thinking?” at some crucial point In the design process. You'll 
most certainly need more than some arcane program sketches and tangles nfwire tn figure tills out. 

Better yet, pretend that someone eise will take an interest in your design. For all you know, they may 
even want to follow In your pioneering footsteps and re-create your clever invention for themselves. 
Show them the way. Leave a trail of breadcrumbs. Write it down. 


Note If you don't write it down, it didn’t bap pen, 
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Source-Code Comments 

You already have one of the simplest yet mast powerful tools at your disposal to help document your 
projects. Can you guess what It ls? It's the code editor in the Ardulno software. 

If you type in the magical characters N (two forward slashes), you can type anything you want from 
there to the end of the line. The editor saves these program comments along with all the real code In 
your sketch, and even remembers to bring them back when you reopen the file In the future. Even more 
amazing, the compiler completely disregards these comments and properly and efficiently works on the 
real code only. You can write anything in these comments. You can was poetical, describe your inner 
feelings, spin yarns about distant worlds ... or e xpla i n y ou r ri diculou sl y convoluted attempt at 
programming a compu t er document your most elegant solution to the problem at hand. 

There's no excuse not to properly document your code by using a bunch of single-line comments 
here and there. If you get really wordsome, you can use block comments, beginning with the f* 
character sequence and ending with the reverse, *L This latter method lets you span multiple lines of 
code without having to Introduce each line with the double- slashes. See Listing 9-1. 

Listing 9-J. Good Use of Program Comments 
H f ilenaise.pde 

// This is the main file in the "example" sketch 

// Written by A, Programmer on 31 Dec 2099, ema iliSex ample. co« 

// Placed in the Public Domain 

// Based an examples found at arduino.ee 

U version l.l 


...or... 


/* filename. pde 

This is the sain file in the "example" sketch 

Written by A. Programmer on 31 Doc 2099, emailfcexample. com 

Placed in the Public Domain 

Based on examples found at arduino.ee 

version l.l 


Here arc some genera t guidelines to good commenting: 

* Use comments generously. 

■* Put the most important information first, where ITs easy to find when searching. 
■* Write for your audience: specifically h untans, not machines. 

* Be thinking of titfio is going to read these comments, when, and ivhy. 

* Explain, giving context, before defining. 

* Cite your sources; give attribution where it is due, even if it s yourself. 

* If your sketch has more than one file, fist ail those flies on the first page. 
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* Always Lise any special d ependencles nr require men is (for example, libraries nr 
hardware) in detail* 

* Don't be cryptic or lazy; neither is helpful. 

* Exp la I n any c lever or non - obvious hi ts in d eiail . 

■ Use more comments. 

It's a good habit to practice. The more you practice, the hotter you’ll get, and the easier It will be. 

The rewards are certainly worth tlie effort. 

The examples In this book have had scandalously few comments inserted* in an effort to make the 
overall program listings less intimidating. It's a sad but true phenomenon that even creative and 
talented folk sometimes go all blurry-eyed when confronted with a big slab of code. This isn't true of 
everyone, of course, but It affects enough readers to warrant keeping the comments In the examples here 
to a minimum. 


Whitespace 

Claude Debussey Is quoted assaying, “Music is the space between the notes." The whitespace in a 
program listing (that is, the spaces between words and lines of text) helps to visually separate and define 
the various elements involved.. When this helps to communicate the meaning and Intent of the 
programmer, It's a good thing. 

The compiler ignores whitespace, for the most part. One of the first phases of the interpretation of 
the source code, long before it's resolved Into ones and 2 eros, Ls the wholesale massacre of whitespace. 
The laws of syntax Implicit In the grammar of the C language allow each and every individual token* or 
unique program element, to be identified without the presence of decorative whitespace, with only a few 
exceptions. 

Whitespace, like source code, Ls for people. It makes things easier to read. It breaks up otherwise 
tedious or incomprehensible blobs of text, turning them into sentences, paragraphs, couplets, and 
verses. 

Listing ft-2 is your old friend, the example sketch IMInk. provided with the Arduino software. It's a 
good example of the use of both single-line and block comments, as well as whitespace. Comments are 
in light-gray. Compare It with Listing 9-3, which is, from a machine standpoint, identical. Which ooe 
would you rather read? 

Lifting $-2. The Blink Example Skeicli 

/* 

Blink 

Turns on an LED on for ane second, then off for one second, repeatedly. 

This example code is in Lhe public domain. 

*/ 

void setupO { 

// initialise the digital pin as an output. 

// Pin lj has an LED connected on most Arduino boards: 

pinMode(13, OUTPUT); 

} 
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void loopO { 


digitalnrite(l 3 , HIGH); 
delay ( l DOO ); 
d ig it a lwi ite ( 13 , LOW ) ; 


// set the LID on 
// wait for a second 
H set the LED uff 
// wait for a second 


delay ( 1000); 

} 


Listing $-£. The BUnk Example Sketch as (tie Comp tier Sees ic 
void setupO{pin,Hode(tj J OUTPUT); } 

void loop(){dl^itaLWrite(l3> HIGH); delay (lOD00;dlg.italWriteCl3j,LOW);dclay( 1000) ;> 

Both sketches compile 10 exactly the same site and perform identically. Which one would you rather 
maintain? Which one would you rather debug? Which one would you use to teach your children to 
program? To which one would you sign your name? 

Note that a single space is still required after tire return-type Identified void. This Is usually tire case 
with any modifier, such as unsigned int or volatile byte. Otherwise, all that nice space evaporates 
away. 

In this era of free gigabyte e-mail accounts and low-cost terahyie hard drives, the cost of whitespace 
is almost incalculable. Consider it free. Use it accordingly. 


Use meaningful names in your code. Except for tire setup{), loopO, and Interrupt handler functions, 
you get to name everything, including functions, variable, and even filenames. 

Every chance you get, be descriptive, It's Ok to use 1, j, and k as variable names when they're used 
as simple Iterators. If they're going to hold any other values, take a minute and give those variables 
decent names that reflect their function and purpose in your sketch. Be concise, hut please don! be 
afraid of typing a few more characters here and there. Future generations will thank you. The only 
names you can 'ruse are the keywords of the compiler, such as if, while, continue, and so on. 

When possible, use functions as subroutines to help reduce repetitive code. Breaking up the 
problem into smaller problems is the first step toward solving the overall problem. Breaking your code 
up into meaningful, abstract functions helps spell out your algorithmic intent. This has an overall space- 
saving advantage as well. 

Functions should be well documented, both Internally and externally. Internally, there should be at 
least some indication, in Lhe form of a program comment, of why the function exists and what task it's 
expected to perform. Additionally, It's helpful If the parameters, If any, that are to be supplied by the 
caller are explained in detail, along with some interpretation of the return value, If any. 

Data structures should also be carefully documented. Even scalar variables should have some clues 
associated with them as to their purpose, function, and usage. A good variable name Is a good start, hut a 
meaningful comment doesn't hurl, either. 

These are all good suggestions for the documentation of your project that you can embed within the 
source code Itself. Remember, however, ihaL all the comments gel thrown away by the compiler and 
don't get to go live with the executable code in the flreat Upload In the Sky. Consider providing them a 
more permanent afterlife In the form of a user manual, or at least a theory of operation note attached to 
the source code. 

Externally — that is, in a separate document — the overall operation as well as each of flic functions 
should be documented with at least as much information as Js presented In the source code (Intended 
purpnse, parameters, return value, and so on). Additionally, a diagram or description of the program's 
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hierarchy, illustrating the relationships between the various modules, will help developers now and later 
to understand the content in which each elctneni belongs— the big picture, so to speak. 

This external user manual of the program’s inner workings should also help paint a picture of the 
various algorithms and data structures that are being used Jo the sketch, liven the simplest example 
sketches like your favorite, Blink, can be categorized as a procedural algorithm: that is, do ibis, then do 
that, then do this other thing; repeat. If your sketch uses a loop within another loop, take the time to 
explain why. This is nef always obvious to a third party. Be specific when you can. 

One problem that often crops up in writing good documentation is that it sometimes lags behind 
changes in the code. 1 1 ere is a common scenario: the code is written, tested, approved, and shipped. 
Meticulous detail was taken to document all the ma jor aspects of Its operation. Then a hug is reported 
from the field, a source code change is made to address it, and somehow this Improvement fails to make 
it into the. 1 annals of history. Now the project and its documentation are out of sync. This can only lead to 
trouble when those tasked with maintaining the project's design rely cm the documentation to provide a 
trustworthy source of internal information and Insight. 


Automated Documentation 

There are several ways to help automate this documentation process, each with its own strengths and 
weaknesses. A good example Is the documentation for the avr-Libc library, which relies on the D oxygen 
documentation suite. The entire documentation package fortius critically important piece of software is 
automatically generated from program comments contained in the source code for the library. As 
pointed out in Chapter ?„ these comments aren’t ah correctly updated. This results in. the downhill seep 
of error Into the documentation. Even though the documentation process Itself has been automated, it 
still doesn't work by magic. A saying as old as computers themselves states it succinctly: "Garbage In. 
garbage out," 

This is no indictment of the D oxygen automated documentation software used to produce theavr* 
libc manual. It does its Job. The problem goes back to the original source code, and simple errors made, 
usually when large changes are made to the code to accommodate new devices. 

Doxygen works by using specialty coded comments In the source code. This is similar to the Javadoc 
system that Is available for Java programmers, as well as many other automated documentation systems. 
The Ctf language supports documentation comments but isn r t well-supported by real-world products at 
this time. 

The Ardulno software supplies no automated documentation system, nor does it endorse any 
particular form of documentation. 


Writing For Your Audience 

Your source code has at) audience. The audience Is the compiler. The compiler is pretty specific about 
what it will accept. This helps narrow down the otherwise-unlimited array of potential sketches you 
might try to compile. 

Although it's possible for humans to read your source code, they aren't the intended audience. The 
comments contained in your source code are Intended for human consumption, however, so please 
write them accordingly. 

For example: people like to delect patterns. They like to see relationships among various items. This 
is the beginning of understanding. People like to understand things, at least to the point that they can 
effectively utilize something to their benefit, 

Anywhere from zero to a very large number of people will come into contact with your handiwork. 
Some of these people win want to see how it works, In the broadest possible sense, without delving into 
the actual implementation details. A good example is someone looking at your Ardulno code and 
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thinking about using the underlying algorithms and data structures oat a different platform to 
accomplish something similar to what you've accomplished. Others will want to scrutinise every detail, 
looking for possible optimizations or vulnerabilities land not always in a helpful way). Talk to these 
people in your writing, both in your code and in ynur other documentation. Let them know what you 
were thinking, what you Intended to do, and potentially even why you discarded alternative approaches. 
This will help you most of all, if you ever get the chance to come hack to this place in your history. It will 
most certainly help others following in your footsteps. 

Some people coming across your creations will be interested in learning only enough to use it 
toward their own goals. This typically describes lire largest part of your audience: the users. Maybe this is 
someone wanting to Incorporate one of your useful libraries of functionality into their own projects: for 
example, a particularly well-optimized hardware driver fora special peripheral. Or perhaps It’s the end 
user, the person or persons you originally Intended to benefit from your w r ork. Talk to these people as 
well. Get them going quickly, with enough information to accomplish their Intentions, but not so much 
as to overburden them with needless implementation trivia. 

Know your audience, anticipate their questions, and help them achieve something close to your 
state of enlightenment. You figured it out. Now your Job Is to pass that knowledge onward. A cryptic 
sketch and a tangle of wires are just not good enough. Volt can do better than that. 


Hardware Documentation 

Does your latest experiment involve some special hardware? If so, you need to document that, as well. 

Even If you use common or popular hardware, please consider documenting how lt r s used in your 
project. What Is common or popular today Isn’t always so. lust because the vendor of that handy 
Ardui.no shield posts a datasheet on its web site today, don’t assume this will live on through the ages. 

The best way to start with your hardware documentation Is by drawing a block diagram and labeling 
all the major components. Do this first from a functional perspective. Show the inputs, the outputs, and 
that middle part. Show any special power supplies or connectors needed. Give every block item a name. 
Then go hack and hreak down each block, describing whai It does and only then hate it thu's it By 
disassociating the Intention from the Implementation, you can later come back and easily augment or 
improve your design as newer techno logics emerge, 

Once upon a time, a 20 M B bard drive with a controller could cost over $1,000. Then you had the 
privilege of writing your own device driver for it. Today, multigigabyte SD cards cost less than a cup of 
fancy coffee. The hardware to Interface it to your circuit is similarly inexpensive. Libraries to use tire two 
together are free for the taking. 

Don't assume that the solution you envision today Js the only possible solution to the design 
problem at hand. By decoupling the udmrfrom the ftotv, you can take advantage of the potential of 
others' work in the future. 

Your block diagram can be as simple as “ here is the Ardulno" and "lie re is the shield" and " here are 
the things that plug into the shield.” Start at a high level, and work your way downward. Sec Figure 9-1. 
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Figure S-i. A simple black diagram shows the high level organization of your project. 

You can later go into more detail about [be Individual components, as shown in Figure 9-2. 



Figure 9-2. A more detailed block diagram 
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If yotTre designing your own circuit [hat will plug Into your Arduino, you can go about documenting 
that circuit in a number of wavs. The traditional approach has been to draw an electronic schematic, as 
described In Chapter 4. This Isn't strictly required. It may he easier to simply lake a picture of a prototype 
you've built, as long as enough Information Is visible eo be able to understand what is going on in your 
circuit. Once you've gone pasta very basic level of complexity, however, this solution wont serve you 
well enough. 

If y our intention Is to show others how to re-create your design, a schematic Is almost considered 
mandatory. Remember, a schematic is nothing more than a stylized representation of the essential 
elements of any system, along with indications of the relationships between those elements. In an 
electrical schematic, those elements are usually electronic components and connectors, and the 
relationships between them arc usually wires. For a schematic diagram of this project, see Chapter 12. 


Going Further 

if you want to go past the prototype stage with your design, you need more documentation. The needs 
change depending on what you're Inventing: hardware, software, ora combination of the two. h doesn't 
end there, however. Maybe you're designing decorative sleeves for your Ardulno projects, or cool 
stickers to put on the project hox. All of these things have to be written down, drawn up, and sent off to 
someone else, more than likely. 

Software 

The nice thing about software is that It usually doesn’t weigh much. This makes it easier to distribute. 
Even so. It needs a nice box to travel In and perhaps a letier of Introduction for when It arrives at its 
destination. 

The Arduino software stores sketches In a file with an extension of . ino, as of die Ardulno 1.0 
release. Previous versions used the traditional Processing sketch extension, .pde. The software also 
organizes your sketches by putting each one in a folder by itself. That folder usually has the same name 
as your sketch. To share your sketch with someone else, you need only provide them with the sketch file 
itself. When tire next user opens the sketch, the Arduino software offers to automatically create a proper 
folder for it io live Ln. 

If your sketch Is simple enough, you may get away with a well-written summary contained within 
the sketch in the form of succinct program comments. Anything that isn't obvious should he spelled out 
in detail, such as library usage or special hardware. 

Beyond a very small range of trivial applications, you should seriously consider Including a README 
file along with your sketch and other files. This Lsa good place to include an overview of the care and 
feeding of your creation. Also apropos would be contact Information, should the user warn to ask 
questions or suggest improvements. 

Always include a revision number of some sort with each release, even If it's Q.Ofl. Eiach time a 
change is made, pfetfsejot down a note about what changed and why, and then bump the revision level 
appropriately. 

Have you decided how you want to license your valuable intellectual property? If so, do include a 
note to that effect In the project documentation. More on your licensing options later in this chapter. 


Hardware 

Hardware, the kind that is made of atoms and such, occupies space, costs money, and usually lias a fixed 
shelf life. It almost certainly needs some sort of documentation attached, affixed, or associated with it. 
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Sometimes that's as simple as clearly labeling the power switch with ON and OFF markers. Please bear 
in mind that not everyone reads English. Iconography, however, sometimes leaves a lot to he desired. 
Consider the "e-mail or bacon switch found In some ears, which was supposed to indicate a vent 
control. 

As mentioned previously, If your hardware contains electronics, you should think about including a 
schematic diagram along with your other documentation. A schematic can serve several functions. It 
can he used to explain how tire circuit works, it can serve as model for a detailed theory of operation. It 
can he used to assist in troubleshooting and diagnosing problems, It can also be the basis for a printed 
circuit hoard i'PCB) design. 

A PCD, requires even more specialized documentation. Even if you're making your own PCBs at 
home, you still need to convert the boxes and squiggly lines of the schematic into actual pads and traces, 
representing Lire copper layer, along with an indication of the board's outline [sometimes called the 
border or profile) and where the holes, if any. need to be drilled. You learn more about PCBs and 
hardware design in Chapter 10. 

Sometimes hardware is simply the hardware: the h rackets, screws, covers, and other non electrical 
components of your project. Whatever you envision, there's a kind of drawing [or drafting) specifically 
for that. 

Are you using off- the-shelf parts in your design? Then tell where ro get them, what they’re called, 
and what users should expect to pay for them, If possible. Manufacturer names, part numbers, 
distributors, datasheets, and web sites ate all good information to pass along. It will certainly also help 
ymt In the future wlten you come back to this project after a period of time. 


Teamwork and Collaborative Development 

Will you be working with others on this project? I low will you coordinate and communicate your Ideas 
and work product between design team mem hers? Several methods are available for sharing the load. 

Even if you’re doing all the work yourself, there's still the possibility dial you may want to ask for 
help in the future. Perhaps you'll want to share what you've done with your local club or the entire 
world. These are all good reasons to arrange your project so that it's easily accessible to others. Let's look 
at a few cheap or free tools at your disposal to achieve these goals. 

Blogs 

Once they were called web logs; online diaries; or journals of individuals' ideas, expressions, or 
whatever. People are awfully busy these days, so the name has been shortened to blogn to save time, You 
can share long or short essays, photos, videos, music or just about whatever you can think of using a 
blog. These are generally distinguished from other content-management systems JCMSs] by their 
journalistic format, wherein a single topic is contained In a single article, arranged by date or subject, 
and searchable by h logger- defined tags. 

People often use their biogs to document their progress on development projects. Til is could he 
anything from an Arduino shield to building a tret-house or proposing to a fiancee. This list is limited 
only by the very human need to document tilings. 

The Arduino Team keeps a btog at http://arduino.cc/blQigand posts Interesting Arduino projects 
and other Arduino news. The blog headlines are fused into tire Arduino main page as well. As you might 
expect, you can find blogs dedicated to every conceivable interest, with a little searching. You have been 
warned. 

You can easily create your own blog and post your own ideas, pictures, projects, and whatever else 
you want the world to see. This is a great way to get into the habit of documenting your projects. If your 
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blogging platform allows reader comments, you can sometimes get a lot of great Ideas, suggestions, and 
help from unexpected sources. People like to browse through other people's work and sometimes will 
offer helpful bid vice or constructive criticism. Of course, you can expect a certain number of soreheads 
and pranksters in Lite mix, so either set your reader comments to require approval (by you) or be 
prepared to regularly monitor what's going on. That's Just the nature of things in this connected world. 

You can get your own free blog from various providers, each with Its own strengths and weaknesses. 
WordPress (http : //uordpress. con) Isa very popular and powerful system that has many other features 
besides blogging. There is a hit of a learning curve, due to the sheer number of features It provides. 

Poster ous ('http://posteraus.corii) lias to he the easiest blogging platform to use. It has the 
traditional web-based user interface as well as an e-mail-driven Interface. You cat] e-mail your hlog 
posts to the site, which automatically formats whatever content you send into a readable, searchable, 
attractive article format. This can Include photos, documents, music, or just plain text. If a also possible 
to automatically forward all your posts through Posterous to social media sites such as Facehook, 

Twitter, and FIJckr. so it looks like you're diligently updating multiple web sites when in reality you sent a 
single e-mail. 

Forums 

The Arduinn Forum {http://arduino.ee/foruiti) should be your first stop for all Ardu in o- related 
questions. If you're pondering an Ardui no -related conundrum, it’s quite likely that several others In the 
past have similarly pondered similar conundrums, all of which Is very often documented in detail in the 
forum. You must sign up fora free account 10 he able to post to the forum, bui you can search and 
browse anonymously If you tike. 

It’s always a good idea to search through a forum for your topic of interest before posting a question. 
The Ardui no online community as a whole tends to be patient and helpful. Please perform your due 
diligence and at least do a cursory search for your topic before asking for help. Also, don't expect 
strangers from around the world to do your homework for you for free, Just because you were either too 
lazy or waited until ibe last minute to turn something in. Show a little respect and appreciation and, 
you'll be rewarded. 

Along the same lines. If you see a question on the forum acid you have some relevant experience that 
might help, consider posting a helpful answer. Vague generalities and "l read about It somewhere so l 
think It should work..." aren't as useful as you may imagine. 

The official/ unofficial support forum for all things AVR (not just Ardulno- related] Is AVR Freaks 
(Kxy.avrfreaks.net), the Mr. I AVR Community. The site has a comprehensive collection of tutorials and 
projects documented online, as well as an enormous pool of AVR talent contributing to its support 
forums. Aim el officially endorses AVR Freaks for AVR support for hobbyists. Ii r s a good place to ask 
questions, but again, be prepared to at least search the forums first before asking a question that you 
think may have cropped up before. 


Wikis 

A u r (kt is a user-editable collection of organized information, presented as a web page. The most famous 
wiki Is Wikipedia, Ihttp: //en„ wikipedia, erg), whose aim Is the sum of all human knowledge. 

Several Ardulno-themed wikis have popped up over the years, including the official Ardulno 
Playground (http://arduino.ee/playground). A huge number of top-level categories exist, each 
containing dozens or hundreds of topics. The new Ardulno Labs wiki (http://labs.ardeino.ee) is also 
getting some interesting topics, including the Mega Android Development Kit |ADK) and GPRS Shield 
projects. 
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The good thing about wikis. Is that anyone can edit [hem. The bad thing about wikis is that anyone 
can edit them. 3i r s certainly an Interesting format. Depending on the user community, it can also he an 
interesting experiment In democracy and free speech. 


Revision Control Systems 

Keeping track of changes and revision to your project caii be tricky, hut it's very important. li r s 
important to your sanity ("I'm sure! fixed drat bug already’") and Li's important to anyone else who may 
want to work on your project. 

Revision control systems, also known as version control systems assist in this endeavor. A perfectly 
acceptable system is to keep the master drawings locked in a drawer and allow only one person at a time 
10 look at them or make any changes. In this day of electrical computing devices and robot memory 
banks, it's also possible to use various softwa re systems to keep track of what's been done and when. 

A good revision control system allows you and anyone you designate (perhaps even the whole 
world) to gain access to not only the most recent version of your work, but also any previous versions, If 
need he. A more useful system keeps track of the Individual modifications made and can help keep a Log 
of changes. The best systems are easy to use and unobtrusive, allowing designated individuals to check 
out a tile, module, or some other subset of data; perform improvements on Li: and then check in the 
results, leaving a noteas to what was done for future reference. You can even get some systems to notify 
the proper folk when selected events occur. 

There's always more to it, of course, hut that's the basic Idea. Revision control systems have been In 
place in one form or another since people stated writing things down, which was a long time ago. Today, 
word processors, wikis, and hlogs often support some sort of version control system. Some operating 
systems employ a versioning file system that automatically keeps track of changes made to files 
contained in the system. 

Different projects use different revision control systems for different reasons, not a II of them good 
reasons. A lot of it has to do with a project's legacy or origins, as well as the preferences and skill sets of 
the developers making these decisions. Different project -ho sting services offer various combinations of 
version control systems, and this very often dictates the facilities and functionality available to 
developers. 

The Arduino code, for example, is hosted by Google Code (http 'Ji code . google. com/ p/arduino) and 
stored as a Git repository on Gltl luh (http : //github^eiWarduino/Ardulnf}). 


A Note About Revision- or Version-Numbering 

The terms version and revision both imply change of some son, oral least the possibility of change. A 
version Is one particular configuration of a system, whereas a revision describes a chringe for a re- 
vision ing) in the configuration of a system. 

Unfortunately, these terms are often used interchangeably, even when their meanings differ subtly. 
Tire first one you make is Version l , which used to be called the Mark 1 hack when people still used 
roman numerals, 


Tip Don’t use roman numerals. If you must, don't mix them with other numerals. 
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When you improve the Mark I enough to need to distinguish between the new! improved! version 
and the original version, you can call the latest version either the Mark II, Version 2, or Revision /. That's 
because this is the jTrir revision or change. 

So it's OK to eall a new product Version Lb, but It's a bit misleading to refer to it as Revision i.U, 
because it has yet to be revised since It was released. 

Feel free to use whatever version numbering scheme strikes your fancy. There is a trend toward 
increasing the major version number for major Improvements, say front 1.0 to 2.0, and humping the 
minor version number Tor Intermediate or incremental changes, such as hug fixes, minor improvements, 
or other enhancements that don’t affect the perceived usage of the system. Anything that fundamentally 
changes the operation of or Interaction with the product should he considered a major enhancement. 
Again, you're free to use your best judgment In these cases. 


Project- Hosting Web Sites 

Let s say you've got a great idea for a project, and you want to share It with others. There are a lot of 
project -hosting websites that would love for you to move on in and get to developing! 

First you should look around and see if there's already a project similar or identical to the one you're 
presently imagining. I ley, it's possible. Try to find a group that already has some momentum, and you'll 
likely get farther with that idea of yours. 

If not, then let's look at a few of the many popular project-hosting web sites. 


Google Code: code.google.com 

Open source projects can find a free home with lots of collaborative development tools at Google Code. 
The requirements are that you have a Google account, that you live in a country where Google Is allowed 
to conduct business, and that your project be licensed as an open source project. 

To create your own hosted project on Google Code, go to tire Create Project page at 
http t // code . googl e . com/foos t iflg/c r e ate Pxo j ec t . You need to s Lgn in using a Google aeco unt. If yo u 
don't already have one, you can create a new account right there. 

Enter the name of your project (which should he unique). 3i has to be all lowercase. Then enter a 
short summary and a project description. 

Now you get to pick what kind of version control system you would like to use with your project. 
Your choices are Git, Mercurial, and Subversion, which are ail popular systems, 

At this point you also get to select which license you want to use for your project. A specific list is 
provided, but it Includes Other Open Source, allowing you to specify the exact license in one of your 
project hies. Remember, to qualify for free project hosting from Google Code, your project must be open 
source. Google doesn't recommend placing your project in the public domain due id liability issues, but 
will consider It if you make a good case by entering an issue in their public issue-tracker at 
htt p : // c o de . googl e . com/ p y s upper t / i s s uesV ervt ry . 

Next, enter some project labels that will help others find your project. Sample labels are provided. 

That’s all it takes to complete the preliminary setup on Googie Code. Now you can begin 
administering your project by adding other users, defining their roles within the project, and adding 
files. 

Google Code offers wiki pages for your project, an issue tracker to keep up with bug reports and 
enhancement requests, as well as a wide variety of notifications for keep log everyone on your team up to 
date. Google doesn't place ads on project web sites. 

The Arduino software is hosted by Google Code ( h tip :// code .google, com/ p /a rduino) as is Trltxing, 
the Sanguino, the LoL Shield, the BilnkM, the Meggy Ir, and an insane number of flying robots controlled 
by Arduinos. 
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Microsoft's CodePlex: www.codeplex.com 

Microsoft also 3ms an open source project hosting facility called CodePlex. Not surprisingly, it's largely 
dominated by Microsoft- related technologies, but because that covers a large an area of interests, It's not 
too terribly confining. 

You can create your own project at CodePlex by visiting the Create Project page ai 
■awm .codeplex.com/site/project/create. You can either use a Windows Live ID or register for a 
CndePLex- specific account. Registering for a CodePi ex-specific account is fast and easy. You’ll get an e- 
inail with a link to finalize the registration of your new account. Click that link., and you’re ready to login 
and create your project. 

Enter tire name of your project on the Create New Project web page. You also get to pick a URL for 
yo u r pro] ec t a to n g t b e lines of http : / / {your -projec t - rid, ire J . cod ep lex . com as lo n g as yoir r-ptoject- nam e 
contains only letters and numbers. 

Then pick tire version control system you want to use for your project. Currently your choices are 
Mercurial or Team Foundation Server, which also speaks Subversion. 

Describe your project briefly In the Summary area. Eetting the world know how wonderful your 
project Is and how the world will be a better place because of It. Or he truthful — you decide. 

CodePlex also offers you the opportunity to fund your project by placing an advertisement on your 
project pages. You can optionally elect to donate this ad revenue to Habitat for Humanity International 
(http: //ha bitat.org]. The ads and any resulting revenue are handled by Lake Quincy Media 
(iom. lakequincy.com. You need to contact them directly to arrange payment. 

You're asked to confirm your e-mail address to set up your project, You have .10 days to upload files 
and publish your project. Unpublished projects get deleted in 30 days. 

You get an e-mail from CodePlex with ail the Important details about your project, including the 
publication deadline. Keep this e-mail handy because it contains a lot of good Information about how to 
access your project. 

You now have a place for your project to live: http: //your -pro ject-iferc.codeplcx.com. You can 
create wiki pages, upload code and documentation, track issues, create releases, and add more 
participants to your project. 


Launchpad: launchpad.net 

Lao neb pad Is the project hosting site provided by Canonical, Ltd. (http: //canonical, com), the nice 
people who bring us Uhuntu. it's based on the Bazaar version control system 
(https r//launchpad . net/bzr). 

Most of the common project-hosting features are also found on Launchpad, including bug tracking, 
code hosting, version, control, and mailing lists. Some of the unique features of Launchpad are crowd- 
sourced translation facilities and a contributor rating system called karma. 

You need a Launchpad Login Service Account to use this project hosting site. Enter your name and 
e-mail address and pick a password to create a new account at 

https :7/login. launchpad. nct/t6tYJ*ZvgsViGRRV/+new_account. You must enter a strong password 
containing at least one number and an uppercase letter. The site then sends you a confirmation e-mail 
containing a six -digit confirmation code. Enter this code on tire page where you requested a new 
account to continue the sign-up process. 

Once you can log in to your Launchpad account, go to https://Launchpad.net/projects/tnew to 
create a new project. There you enter the name of the project as well as a URL in the form 
htt pst //launchpad. net/ [your- project -fierej a title, and a summary, Launchpad uses ibis information 
to search its database of exist! og projects, it lists anything similar on a page where you can either cancel 
or cootinue. You're brought back to the project- creation page and allowed to enter a more detailed 
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description of the project, add a homepage URL, and select which licensed) you would like to use for 
this project. 

Now you're sec up to add other users* upload your code, track issues, and set up releases. Go nuts! 
Launch pad hosts some fa mo us software projects, including Ubuntu, MySQL, and Ink sea pc. 


GitHuta: github.com 

Gitllub offers free hosting for open source projects, with unlimited public repositories and unlimited 
public collaborators. It also offers paid services for private repositories. 

Gitllub claims so be the most popular code boston Earth, with over two and a half million hosted 
repositories and close to a million developers. To create a free site for your project, sign up fora free 
personal account ai https://github.com/signup/free. Enter a username and your e-mail address, and 
pick a password. That's all there is to it. 

Now you can create repositories for your code and documentation. You'll probably want to get up to 
speed on how the Git version control system works and net up the required software on your computer 
( if it 's not al ready there) . The gu ide fo r Wind ows use rs is at h 1 1 p : // he 1 p . g it hu b . c om /w in - s ct - up - gi t . 
Mac OS X users should look at http: //help. github.com/ mac- set-up- git, and Linux users go over to 
http: //help, git hub .com/linujt-set - up-git. 

On Windows, the Git software will want to modify your system PATH statement. You should allow 1 It 
to do so* because [bis will lei you use the command -line versions of the tools from anywhere In your 
system. 

You may have heard of some of GltHub's users: Twitter, Faeebook, Digg* and Yahoo!, among others. 


SourceForge: sourceforge.net 

This is the grand mother of ail open source project-hosting sites, k was open source before open source 
was cool. 

To create a SourceForge account* goto https://sourceforgc.net/uscr/registration. Enter your 
name as you would like it to be displayed, your e-mail address* your preference for a username ([bat you 
use to login)* and a password. You can also enter your preferred language, the country you live in as well 
as your time zone* and a security question to be used in regain your password should you lose irack of ii. 

To create a new project* go to https: //sou reef orge.net /p/add_pia ject. Enter a project name and 
UttLfto be added to the end of http://soureeforge.nct/p/j that is 3- IS characters long. Then select 
which options you want for your project: Git repository, SVN , or Mercurial version control: a blog: a 
download and stats page; a wiki; a ticket system for tracking issues; and a forum. That's a lot of stuff for 
freet 

After you've created your project, you proceed to the Project Admin page where you can reign 
supreme. 


Licensing Your Work 

To share or not to share ... that is not the question. The question Is, how will you share your ideas? 
Maybe you have no intention of sharing your Ideas. Fine. Be that way. 

Let’s assume for the moment that you do intend to share your ideas, at least to some degree. You 
need to know what your options are and what's best for you* as the parental figure in your idea's growth 
and development, as well as what's in the best interest of your Intended audience. 

These are important decisions. Please take them seriously. 
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Note Ideas, like cats, are sponsored, not owned. 


If you don't want to share, that's OK.. Keep all your toys In your own yard, and don't let anyone else 
play with them. But consider for a moment wliai benefits you may enjoy if you consider sharing your 
ideas with others. Wealth, fame, honor, and Immortality are, unfortunately, not guaranteed and, to he 
quite honest, are doubtful. Respect, appreciation, and a sense of satisfaction are much more likely. 


Note Nothing in this book is to be considered legal advice of any kind. Double-check any statements made 
with the laws of your particular jurisdiction. Retain your own counsel when contemplating any legal issues. 


Patents and Trademarks 

The idea behind the modern patent system Is to give inventors some legal protection for their Ideas. This 
was supposed to encourage innovation. Sadly, for the most part, this is no longer true, especially in the 
rapidly changing areas of high technology, such as computers, chips, programming, and, well, Ardutnos. 
Also, sadly, It's not helping the pharmaceutical world, either, which could really use some help. 

A patent can be awarded for a device (usually called an apparatus), a process, or a design. Device and 
process patents are collectively referred to as mllity pa rents. The exact rules vary from country to 
country. The basic patentable concept embodied in this new hit of shiny Is supposed to be in some way 
new, useful, not derivative, and nor obvious, ft was once considered to be In society’s best long-term 
interests to give an inventor a short-lived monopoly on the use of the product of their fertile 
imaginations, in order for It to gain traction In the marketplace and be profitable, without the Inventor 
having to worry about others stealing the idea. 

Many people seem to think that Lf you come up with a great idea, all you have to do is pateni It, sit 
hack, and wait for the riches to start pouring in. There are a few problems with that theory. 

First , to obtain a patent, you must first apply (thai Is, submit a patent application): a potentially 
lengthy and expensive process that often involves lawyers. This doesn’t guarantee that a patent will be 
granted. 

Within the patent application, everything about the device, process, or design must be revealed in 
detail. Whether the patent Is granted or not, this Information then becomes publicly available. If you had 
a secret sauce that you thought was going to make you rich because you bad it and no one else did, well, 
now they do. 


Note A secret shared is a secret no more. 


If your offering of brainwaves and bank notes is acceptable to the pateni deities, you may eventually 
he granted a patent. Unfortunately, although you do get a fancy multidigit number and bragging rights, 
you do nor get a magic bullet that kills evil. Idea-stealing nogond nicks dead in their evil, idea-stealing 
tracks. What you've earned for your trouble 1s a free pass to a local court of law, wherein you get to spend 
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in ore money prosecuting those you suspect of using your ideas without property compensating you. Of 
course, you have right on your side. Here's to hoping your pockets are deeper than your opponent's! 

It gets worse. Because there Is strength in numbers, many patent holders collectively pool their 
intellectual properties under a common Hag. Often, hundreds or thousands of patents are owned by 
companies that do nothing with them other than to offer protection. This Is seen by some to be the 
inevitable conclusion to such as system, similar to the heat death of the universe, where all matter 
eventually collects Into black holes and disappears from view. This occurs because of the litigious and 
adversarial nature of the patent Infrastructure. 

But what about all those riches that were going to start flowing you -ward once your brilliant Idea 
was patented? Again, unless you do something with the idea, It's Just an idea, like Esperanto or the metric 
system. 

Patents in the United States are ad ministered by the US Patent and Trademark Office 
(http : //uspto .gov], which has atvarded over eight million patents in its £0d+ year history. According to 
the web site, an inventor cart expect to pay approximately S4.00U over the course of the lifetime of a 
patent. 

Trademarks, on the other hand, are sim ply filed lit a public registry oi record. This is a way of 
memorializing a connection between product and owner, as long as a level of distinction and 
uniqueness can be demonstrated 


Copyright 

Copy right means the right to copy. This right is owned by the copyright holder in a work and Is protected 
by copyright laws. That work can be a book, a song, or Just about anything that is an original work of an 
identifiable author. 

Once upon a time, the very process of copying anything was tedious and cumbersome, requiring 
special skills and tools. Today, thai remains the case In a few specialized areas, but not so much for the 
vast wealth of digital works that are available. Making a digital copy is now trivial. 

Copyright laws vary from one place to the next. The level of pro Lection gran ted by law also varies 
tremendously by Jurisdiction. As with patents, the government won’t go to bat for you In these areas, aod 
the burden of Identifying and successfully prosecuting violators lands squarely in the copyright holder's 
lap. 

Asa marketable right, copyright can be bought, sold, or licensed under various combinations of 
circumstances, it can get complicated. For example, you can buy an audio recording of a musical that 
you like and listen to hat home. You can't, however, play It over the public address system at your 
school; It’s not licensed for that. Well, you can, but you’re In violation of the contract that you entered 
into with the copyright holder [or their agents or assignees) when you purchased the recording. 

This can have weird side effects. Since 1997, Canada has collected a blank media levy on ail CD-fCs 
and other blank media and then passed those funds to the Canadian Private Copying Collective, which 
redistributes the booty to authors, publishers, and performers. The Implication is that a certain 
percentage of blank media (high enough to warrant legislation) is used to illegally copy [pirate] 
copyrighted works, and someone’s gotta pay. All European countries, with the exception of 
Luxembourg, have similar systems in place. 

Even so- called free software has copyrights. The original authors may have wanted to share the 
product of their work with the world for free, and to make an effort to allow the software to remain free, 
hut still wanted to retain control of the product and the terms of Its usage. See? Complicated. 

Copyrights are registered In the United States by the US Copyright Office (http://copyright.gov). 


228 


CMAPTE R n PROJECT Pili^J AGE WENT 


Open Source 

The term open source means different things to different people. At its core is the concept of making the 
source code [in whatever form that may take) openly available to any interested party, especially users 
and potential developers. In Us simplest sense, this is a great idea. U fosters Ingenuity by sharing 
previous accomplishments and helps people ''stand on the shoulders of giants," as famously stated by 
Isaac Newton. 

t lere is a simple example. Let s say you write a clever sketch for your Arduino and post the source 
code on your blog for all to see. You have made your source openly available If you design a really nice 
paper-towel holder out of plywood and publish the layout and assembly Instructions somewhere (not 
necessarily the Web), you have likewise participated Ln open source development. Good for you! Sharing 
is nice. 

This openness begins to get confusing when you start to attach licensing issues to the matter, lust 
because you post the source code to your latest sketch online, perhaps either to invite help debugging a 
tricky problem or to share it because you think It could be useful, does that automatically convey a 
license to anyone within the sound of your online voice to use your valuable intellectual property for 
whatever purpose they want with no compensation or attribution paid to you? Some people seem to 
think so. However, the two issues of publication and licensing are completely separate. Revealing your 
secret sauce recipe does let the proverbial cat out of the bag, but does that then obligate you to Ir- 
responsible for the success of anyone else's project that Incorporates your ideas? I low about updates? 
And how far should lire openness extend? If you post a schematic, are you then obligated to also post a 
PCB layout and a hilt of materials? hi how many formats or languages? How long are you required to 
make this information available? 

Then there comes the Idea of restricting the use of your Ideas. Some think this Is important. Maybe 
ynu'rc happy to let others peek under the hood to gel an idea of how your invention works, and you 
wo u td eve n c nco u rage l tole ra te?) b o b b y Ists re p eati n g yo ur ex pc ri men i s e Isew here (t h is i s cal I ed peer 
review in some circles — a mandatory requirement for being taken seriously, it would seem) without 
wanting to allow others to financially benefit from your genius unless you’re compensated (see 
CadSoft’s EAGLE license for a freeware version). What if you want to limit the use of your technologies to 
peaceful applications and prohibit military applications? How can you do tills? 

You do this by carefully licensing your work. A multitude of licensing options are available today, 
some of which will actually stand up in a court of law. A license is a contract between you and someone 
else, specifically detailing Lhe permitted use and scope of your idea or product, hut only under certain 
circumstances. Some licenses are quite liberal, requiring only that the end user think good thoughts 
about the original developer, or perhaps buy them a pizza should the opportunity arise. Others are 
drastic and restrictive. 

In all cases, (he license dictates lhe relationship between two parties, both of which are supposed to 
he gening something of value out of the deal. .VI ay be you get paid, if that’s the deal. The License should 
dictate how, when, and probably how dutch you’ll get paid. Maybe you don't want to get paid, hut you 
do want attribution (credit) for all thal cleverness. Again, the license should spell out exactly how this 
attribution Is to be worded aaid placed In any derivative works. 

Someday, try reading the fine print you always click through when installing software. It was 
common in years gone past that you didn't even own the media through which the software was 
delivered (back when physical media were used); It remained the property of the seller and would be 
required hack at some point in the future. 

Even some open source licensing has lots of strings attached — the kind of strings that can land you 
in court. Everyone knows that Linux, for example, Is free. You can install it on your computer and do all 
kinds of great things with It for no charge. You can even get the source code for it and make a whole new 
kind of gizmo that runs Linux. The licensing on some of the components of Linux, however, mandates 
that you make available any source code used in your product that was based on free software (the 
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meaning of free here pertaining to liberty., not price), thus keeping the source code free. DUi has resulted 
in several lawsuits against companies Iliac didn't abide by the fine print in these license* Because the 
intention nf the original authors of these particular components was for the code to remain free forever, 
these conditions were included in the licensing. 

Licensing, like patents, only buys you a ticket to your local court of law. If you feel strongly about 
who should be allowed to use your ideas, when, and in what circumstances, then by all means, p lease do 
spell out these concerns In your license. 

If. on the other band, you just want the world to be a better, richer place, and you think that sharing 
ynur ideas and solutions with others is the way to do that, then please read the next section. 

The Open Source Initiative (http: / /opensou rce.org] maintains a list nf open source licenses of ail 
kinds. 


The Public Domain 

The pubite domain Isa legal term, so it means different things In different places. The basic 
understanding is that anything that Isn’t copyrighted, or whose copyright or other Intellectual property 
rights have been forfeited, abandoned, or specifically disclaimed, is in the public domain. This means It 
isn't owned by anyone. Another way of thinking about it Is that this means It’s now owned by euerymte. 

The Berne Convention, signed i>y most countries over the past century, imagines that an author 
automatically has a copyright on any fixed work without having to register or declare It. Therefore, to 
place something In tbe public domain requires the author to disclaim any rights In the work. Again, all 
these rules and regulations vary from one place to the next. Some countries don't recognize the concept 
of a public domain. 

A work that is in the public domain is a gift that already belonged to you even before you knew It 
existed. An excellent example of a project whose source code has been placed In the public domain is 
SQLile {http:/7sqlite.org|. a relational database library. 

If you want to send your little thought -children out into the world with no strings attached, please 
consider placing your doc umentatlon in the public domain. The public, thereby enriched, thanks you. 

There is a down side, of course. Depending on your particular situation (that is, Jurisdiction), you 
may still be vulnerable to litigation from folk who use your idea and somehow feel Injured by It. Without 
a specific disclaimer of liability or warranty, you Uy can potentially be sued for damages arising 

from the use of your stuff, even though you gave It away and asked nothing In return for It. There are 
variations of liberally pemiteslve licenses, such as Lhe MIT license, that allow unfettered use of a 
copyrighted Idea for any purpose but specifically allow you to distance yourself from any litigious wrath 
down the road. For more details, ask your attorney. 


Summary 

!t started out as an idea. Then it took shape, growing and expanding and changing until It more closely 
resembled the solution you bad In mind. Do everyone a favor and write It down, won't you? 

Maybe It's just a series of blog posts on your progress (or lack of It). That’s a great place to start, 
especially if you get some good feedback from your readers. Take some pictures of your work along the 
way. !i r s entirely possible that the idea you discard will be ihe perfect solution to someone else’s 
dilemma. 

If you don't write it down, it didn’t happen. Make something happen today. 

Now let's move on and Look at the tools and techniques you need to design, build. lest, and program 
ynur own Ardulno creations. 
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If you want to extend the capabilities of your Arduino, and you find there's not a shield for that yet, don't 
give up hope. You can design and huild your own Arduino hardware. Maybe you want to connect a new 
device to your Arduino, or maybe you need to completely design your Arduino from Lite ground up, 
including connections for the new things you absolutely musi Adeeand dropping all non-essential 
circuitry. Either way, you're going to have to deal with some aspects of hardware design. 

Let’s start modestly and proceed to greater things. You begin like a child, playing with toys and 
imitating others. Next you took at some more complex techniques for both documenting your ideas and 
turning them into realities. You look at some design tools for extending your Arduino’s capabilities and 
then move on to designing your own stand-alone Arduino -compatible devices. 

This chapter can't possibly teach you everything about modern electronic design, and it doesn’t try. 
But llu- examples given here show you wbai Is involved in replicating existing circuits and in dreaming 
up your own. Ideally this will Inspire you lo give it a shot, if you haven't before. If you already have, this 
chapter will spur you on to more ambitious hardware projects in the future. 

The practical goal of this chapter is to give you a good understanding of what tools you need and 
what you need lo know ro build some simple add-ons for your Arduino, as well as to build an Arduino 
clone of your very own. 

Learning About Hardware 

The absolute best way to Learn, and learn tjuickly, about electronic hardware in general and hardware 
design In particular is to get some and play with It. That's right: have fun. Make stuff. Break stuff. See 
what works and what doesn't with your own eyes, your own hands. These are lessons you teach yourself, 
and they will last a lifetime. 

Basic electronic components today are so commonplace and produced in such huge quantities that 
they have become incredibly inexpensive, in fact, Jl doesn't take much looking to find a lot of parts for 
free. If you're lucky enough to live in or near a city [hat has an active hacker space or electronics club, 
you can probably find tors of surplus electronics with which to learn and play. Most of these 
organizations have a free box or collection of donations that can yield all manner of interesting bits. 

Kids, get permission first. Adults, get permission first. 

Also, don't go too far. There's prudent stocking, which is certainly handy when you need that one 
special part in the middle of the night to complete your experiment. This can, unfortunately, lead to 
eccentric collecting that sometimes devolves into disorganized hoarding (see Figure 10-1). There is no 
good reason to house for extended periods of time parts that can be easily and Inexpensively obtained 
with a phone call or a visit to a web site. 
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Figutit W-l. Combination electronics/photography/robenfcs laboratory in ti secret,, undisclosed location. 
j iVo, ffto.se aren't some of the example projects from this book. Don 't let ibis happen 10 you! 

Even if you're not that Lucky* It’s still a good bet that you can find some discarded consumer 
electronic products in your vicinity. The older, the better. You want ftrfdt treasure that lias individually 
removable components, and the most recent crops of gadgets are woefully lean In that department. 


Cauti on T elevision SBts with cathode ray tubes (you re member th e m , don’t you?) are strictly oft limits to 
novice harvesters. These commonplace appliances can contain and retain very high voltage charges for years — 
mere than enough to kill or seriously damage you. Don : t take chances! Leave those TVs on the side of the road. 
Don't open them! 


Even If your Immediate area suffers from a lack of discarded technology, don’t give up hope. As 
mentioned previously, the basic components you want for experimenting with electronic design are 
ridiculously Inexpensive to obtain If you do a bit of comparison shopping online. 


Things You Must Have 

You need a clean, well -lighted space. If you don't have the luxury of a dedicated laboratory, find a nice 
box to pack away your stuff when you relinquish the dining [able. Fishing-tackle boxes are good because 
they have lots of nooks and crannies to organize small parts. 
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Keep your smallest parts separated and organized, and then he sure to put them back in the right 
place when you're done. Don't waste 45 minutes rooting through a pile o f Identical-looking resistors to 
find the right one (this wilt happen more often than you would like} when Ji would have taken you allot' 
2& seconds to put it In the right place io begin with. 

Invest In (or borrow) some in are- than -adequate lighting. It makes a big difference. 

You’ll be making a lot of electrical connections. Wire is really good for this. Smaller -diameter wire is 
better than the heavy stuff, at least to a point. There seems to he a Lot of li hiding In old computer cables. 
You'll very quickly develop a preference as to what size and kind of wire you Eike for your projects. 

You also need real wire cutters and, if possible, some good wire strippers. Don't use scissors or nail 
trimmers, and please don't use your teeth. 

All great projects, even great practice prnjects, need documentation. Graph paper Js good, and plain 
copier paper or notebook paper will do. If you’ve already mastered a computer-aided design |CAD] 
software package, you can use that. If not, please hold off on diving into that particular can o’ worms for 
now. You've got enough on your plate as It Is. There's uo need for more distractions. Pencils (with big, fat 
erasers) and paper will work nicely for now. 

What will hold your prototype circuits together? You can only twist so many wires and component 
leads together before something comes frustrating]/ undone by Itself. You've already seen several 
examples of entire A rdul no circuits built on solderless breadboards. They're relatively Inexpensive, and 
you can cut and strip your own jumper wires at home. If you already know how to solder (more on this 
later, if you don’t), you can use point-to-point wiring In a freeform arrangement of wires or thread the 
com ponent Leads through a perforated sheet of flat material, sometimes called perfboard or the 
trademarked Veroboard brand. As previously mentioned in Chapter 1. you can even breadboard your 
circuits on an actual bread board, using a hammer and small nails. 

The main idea of experimenting with electronics and building prototypes is to learn what works and 
what doesn’t. Find a method that you like that allows you to quickly try one new ideas without having to 
run to the store or wait for things to show up in the mail. I laving a reasonable inventory of tools, wire, 
basic components, and connectors helps. 


Mote Keep a first-aid kit handy. You're going to cut, scratch, or hum yourself eventually. When this happens, 
stop what you're doing and attend to your wounds promptly. 


Things You Want 

Eventually you'll want to memorialize your latest circuit doodling for posterity. This will most likely 
involve soldering. You want a sin all, pencil-style soldering Iron in the 25-50 watt range. You do nor want 
one of those big pistol-grip soldering Irons. Those are for circus tents, zeppelfns, and plumbing. 

When you're first learning to solder or getting hack in practice, it often helps to have an articulated 
vise nr helping-hands device to hold your assembly at that special, weird angle needed to make that very 
East connection. These gadgets come in all sizes and with all manner of options. Start with something 
simple. 

You don’t have to solder to be able to design and build electron ic circuits. But Ji helps. It also opens 
a lot of opportunities for you. if you don't already know bow to solder, you’re encouraged to learn. Mitch 
Altman publishes a great one-page cartoon-style “learn to solder" fiver that Is free to download: 

.tvbgone . corny cfejufalre.php. 

Some test equipment will make your life easier, especially when your newest creation seems to 
develop a mind of its own. You get extra points for huilding your own gear. 
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A continuity tester is a simple device ill at indicates whether there is a con due live path between two 
points. You can make one out of an LED, a coin ceil, a spring-loaded clothespin, and three pieces of wire 
(see Figure 10-2). Alternately you can use a beeper for audible feedback, which is sometimes more 
useful when you need to keep your eyes on where you're probing. Always use a low- voltage power 
source for a continuity tester. Tire common lithium coin cell puts out LWand has enough internal 
resistance to allow you to omit a current-limiting resistor In your circuit. You don't want to blow up a 5V 
circuit by probing it with a 9V battery! 



Figure 202. A continuity raster made with a clothespin (net programming required). The long tend 
{anode} of the LED is wedged under die spring coil (upper right}. 

In Figure 10-2, the short lead (cathode) Is soldered to a wLre, stripped, and looped across one jaw. 
The other jaw Is similarly stripped and looped with a red wire, Forming the positive test lead. The 
negative test lead is wrapped around the spring clip. A 3V lithium cell Is held between the jaws. When the 
circuit is completed, the green LED lights. Also makes a good button -cell tester. A volt- ohm -amp meter 
(VO M> is great to have to lake various electronic readings. For tow-voltage readings of 5 V and lower, you 
can use an Arduino Isec Chapter 7). However, a standard meter or an Arduino is only really effective for 
reading direct current (DC) voltages or very slowly changing voltages. For higher Frequencies, such as 
those Found In audio c ire u its or more complex waveforms, an oscilloscope Is required. 

An oscilloscope is an excellent tool to have on your bench. These have traditionally been very 
expensive items. Luckily there area lot of good deals to be had on used equipment, and the cost of new 
units is coming down, especially For some oF the more humble models. Tills versatile instrument lets you 
measure voltage. Frequency, duty cycle, and many other parameters by visualizing the signal on a 
display, so you can really see what Is going on within your circuit. 

Although a dedicated oscilloscope is an excellent addition to your collection of test equipment, ii 
may not be within your budget, or you simply may not have room for any mere equipment In your lab. 
USB- based oscilloscopes are available in all slizes and price ranges. They generally consist of a small box 
of electronics to house the front-end electronics and do most of the heavy lifting in software on your PC. 


Infrared Proximity Sensor 

As promised, you begin with a project that Is straightforward and not too difficult. An Infrared (IR) 
proximity detector is a combination of an Infrared emitter and an infrared detector. The very simplest 
implementations of this circuit suffer from some pretty severe performance drawbacks, but they can still 
he used In certain controlled situations to accomplish noncontact proximity detection. 

The emitter Is usually an IR LED. Ft looks just like a visible-spectrum LED except you can't see it 
shining. These LEDs are usually packaged in clear resin, although you sometimes find them in various 
shades of gray, blue, or pink. An IR LED's forward voltage is m uch lower than a visible LED's, usually in 
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the 1.2 V- 1.5V range. Ideally, for [his type of circuit, you want to use an IR LED that was originally 
intended for use in a remote control. These IR LEDs are often rated at 100mA maximum current, which 
is four or five times higher than most visible LEDs. 

There are several types of Inexpensive IR detectors. You can use an IR phototranslstor. These often 
took like regular LEDs, except they’re encased in what looks like solid black resin. This coloration helps 
filter out any visible light and allow' only the 3R light to enter the package. Don't confuse this with the 
once-popular darkness emitting diode (DED), a very low -power device used for power-off Indicators in 
the 1970s. 

Infrared phototranslstors are true transistors, but the base terminal usually isn’t connected to an 
external lead because the light hitting the transistor die inside the package is what controls the amount 
of current flowing through the transistor. Therefore they have only two leads and look a lot Like normal 
LEDs. 

A more effective IR detector Is the photodiode. It's also often packaged in a T13V4 or 5mm LED Lead- 
frame, also with a dark resin to block non -Infrared light from entering. These devices act like normal 
diodes in Hie dark, allowing current to flow in one direction but blocking the flow of current In the 
opposite direction. 

There are several types of photodiodes. The PIN photodiode is similar to a normal diode with a P N 
semiconductor junction, but it has an extra layer of utt doped or intrinsic semiconductor material 
between the P-regJon and the N -region. It also lias some unique electrical characteristics when used In 
high-frequency circuits, but you focus on their optoelectronic applications for the moment. The long 
and correct explanation of how this works is Long Indeed. The short version is that if you hook up a PIN 
photodiode backward ([hat is, reverse -biased) It does not conduct electricity In the dark and it does 
conduct electricity when exposed to IR light. This Is functionally Identical to the operation of a 
phototransistor, except that a PIN photodiode lias a much faster response time. For this reason. PIN 
photodiodes are often used as detectors in fiber-optic networks for sending lots of information really 
quickly. See Figure 10-3. 
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Figure .1 b-J, A complete !R proximity-detector circuit, consisting of an IR emitter and IR detector. Note 
that Rl must be at least 1/2W ifV , is 5 V. 

The left side of the schematic in Figure 10-3 is the IR emitter circuit. As drawn., it’s always on, 
emitting 3R light as long as the power is applied. Rl tsa 51£i, L/2W current -limiting resistor, and Dl Isa 
5mm IR LED, preferably with a peak output wavelength of940nm and a beam angle [technically, the 
half- angle) of 20*. This makes for an invisible beam that is rather lightly focused. 

IfV,., is 5 V, then the current flawing through Dl and Rl is about 75 mA. This Is less than the 
maximum for most IR LEDs of this type, but because it's always on, you don't want to run it at 100%. The 
total power being dissipated by Rl is -275 mW, which is more than a common quarter-watt resistor can 


235 


Chapter i o mar dware design 


ever handle. You bump it up to a I /2W resistor so things don't get too hot. Two l ODD, 1 .MW resistors in 
parallel will also suffice. 

The F IK photodiode Is located at D2. ISote that It's reverse- biased. If you didn’t know something 
technical and mysterious was going on, you'd assume that no current would flow from V . through R2 
and D2 to ground, and you'd normally he right. Tills Is the ease when no 1R light is falling on D2. In the 
presence of I Ft light, however, strange things happen with electrons and holes and carriers and such, and 
D2 begins to conduct. The amount of current flowing Is related to the amount of light striking D2. 

When D2 Isn't conducting current to ground — that is, In the dark — the voltage on J2, the output, 
remains at V. . This is because R2 Is acting as a pull-up resistor. However, JfD2 begins to conduct, the 
voltage on |2 begins to drop. The output voltage can be converted to a number by the Ardulno’s ana log- 
in -digital converter (A DC), and you can make decisions based on this reading. 

Because very IJnte current is ever expected to flow through R2, it can be a common quarter -watt 
resistor of anywhere from lOKft-IOOKfi. The esact value of R2 determines the sensitivity of the circuit to 
lit light. A higher resistor value for 112 makes the circuit more sensitive, because it lakes less current 
being conducted by D2 in drop the voltage A lower resistance reduces the sensitivity of the detector, 
because it takes more JR light to achieve ihe same voltage drop. 


A Modest Prototype 

OK, now it's time to quit talking about this circuit and start building it. Let's start with a simple version 
and then make it much more complicated later. See Figure lti-4. 



tflgur# 16-4 r A prototype of the 1ft proximity senior. The positive load (anode) of a PIN photodiode is 
connected to one of the ground pins (GND) of the power expansion connector. 

In Figure 10-4, the negative lead {cathode, indicated by the Hat side at the base of the photodiode 
package) is attached to the first analog input, AC). The 1R emitter is Just an 1R LED powered directly by a 
3V lithium coin cell. The longer lead of the IR LED Is the anode I. positive lead), so It’s placed next id the 
positive side of the battery. The coin celt has enough internal resistance to keep the IR LED from drawing 
too much current. 

Besides an Ardulno, you need an IR LED, a PIN photodiode or an ER photo Iran sis tor. and a3V 
lithium coin cell. Do you see any resistors In this picture? No, you don’t {the resistor networks on the 
Ardulno don’t count!). The lithium coin ceil lias more Ilian enough Internal resistance to safely limit the 
amount of current firming through the IR LED, thus eliminating the need for Rl. This trick works with 
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most visible-spectrum LEDs as well. You use one ofthe available built- in pull-up resistors inside the AVR 
chip to replace R2. 

If you don't have an IR LED or an extra coin cell floating around, the lab, don't fret. You can use a 
remote control from just about any consumer appliance. A special provision in the testing software 
allows for this. 

Let’s test out tins pro to type hardware with a little prototype software. See Listing 10-1. 

Litting W-i. Detecting }R Light Using a Reverse- Biased Photodiode 
void setups ) { 

pinMr»de{l3, OUTPUT); it LED pin 

digitalMrite(l4, HIGH); // enable puLlup on analog input AD/D14 

} 

void loopQ { 

if (an a log Read (o) < 900} { 

digitalWrite{i3ji HIGH); H LED on * IR detected 

delay (i00); // stretch... 

} else { 

digitalWrite{l3, LOW}; // LED off = no IR detected 

} 

1 

This is a very simple sketch, hut it performs a very Important function. It proves that the IR detector 
circuit works. Compile and upload this sketch to your Arduino. Make sure you've got the photodiode 
installed In the correct direction. Also, make doubly sure you have the anode connected to G.ND and not 
the VI N r pin. When you point the coin -cell-powered 3R LED at the photodiode, the LED on your Arduino 
should light. 

Rear in mind that both of these optical components arc usually tightly focused. You need to shine 
the lit LED directly Into the top ofthe photodiode for best results. 

Now let's take a look at the sketch to see what's going in inside. The setupQ function configures D13 
as an output so that you can blink the built-in LED. Then It turns on the huiLt-Jn pull-up resistor for the 
first analog Input, AD, using ihedigital¥rite() function call and All's alter ego, Dl-i. Remember, all the 
analog inputs can also he used as plain -old digital inputs or outputs. As such, they have a built- In pull- 
up resistor that can he enabled or disabled by software control. This would normally skew a true analog 
voltage reading, but it's required in this experiment. 

The loopO function takes a reading of AO's voltage, which corresponds with |2 in the schematic 
previously shown, using the analQgRead( ) function. This value can range from D to 1,023. Due to the way 
you've arranged the components, a higher voltage means less I Ft light detected. As the amount of IR light 
increases, the voltage goes lower, approaching ground. In normal room Lighting (not direct sunlight}, the 
reading should slay above 1,000, because the opt leal properties of the photodiodes container block most 
ambient light. 

The reading obtained using the analogfleadQ function call Is com pa red to the hard- wired value 900. 
If the reading is less than 900 — that is, some IR light is heing detected — then Lhe LED on D l :T is turned 
on. If the value is 900 or above, then the LED is turned off, indicating that no 3R light is currently being 
seen by the detector. 

An additional dclayO function call is made In the event that some JR light is detected. This allows 
you to get a good visual indication oF detected 3R light, even if It’s just a short Hash. 

As previously mentioned, you can also use just about any 3R remote control to test this detector 
circuit. The extra delay() function call helps stretch the positive test result long enough to make It visible 
to your slow, human eyes. 
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Now that you can get some visual feedback about the operation of the IR detector circuit, try seeing 
how far away and how far off angle you can get with the coin -cell-powered lit LED or the remote control. 
Assuming everyth Eng is working property, you should quickly get a good sense of how well this simple 
circuit works and under what circumstances it fails. For example, even Indirect sunlight cat] swamp your 
detector, because daylight contains an enormous amount of I Ft radiation. You can adjust the hard -wired 
SOO threshold in the prototype sketch to adjust the sensitivity of the circuit. With this configuration, a 
lower threshold decreases the sensitivity of the detector, because it takes more IR light to drive tire output 
voltage that low. Experiment with different values and see what happens. 


Some Modest Improvements 

Let's add a few improvements to the circuit. You want to use this circuit as a proximity defect or arid not 
just an IR light detector. To accomplish this, you need to bounce the IR light off of a potential obstacle 
and detect how much tighi Ls reflected back at your sensor. 

It takes a lot more IR light to bounce off a target and measure that] Li does when you can point the 1 R 
LED directly at the sensor. The typical coin cell has enough Internal resistance to limit the current 
•lowing Enough llu 1 Id LED id iiOinA H.hn.\. I his ii less Lit Lin half utils t apacity , so \uu need i.'urrr fH/u-i't. 

You don't need the iR emitter to he blazing away at full power all the time, though. That's wasteful. 
You should turn it on just before you need to Lake a reading, give the PIN photodiode enough time to 
read to the light, take the reading, and then turn off the IR LED. 

You can control the 3R LED directly with a dedicated I/O line, but then you're limited to the 40mA- 
per-pln limit imposed by the silicon chip that forms your AVR. You need an LED driver, it would also he 
nice if there was some sort of visible indication that the l R emitter was enabled. You can use a regular 
LED for that purpose. It’s always nice to have positive, visual confirmation that your sketch Is behaving 
properly. Wasting time trying to figure out why the IR sensor Isn't responding, only to find out that you 
weren't powering the right pin, Is very aggravating. LEDs a re cheap, so you add one to the driver circuit. 

On the receiver side, it would tdso he nice to have a visual indicaiion that something is happening. It 
would he even better if this indicator dldn ‘i depend on the proper operation of the sketch to work. 

Ad di Lion a uy. let's add an adjustable threshold to the sketch, so you can tweak the trigger point 
in real time instead of having to adjust a constant In the sketch, recompile, upload, and so on. See 
Figure 10-5. 
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Figure 10~ J r A more complex proximity-detector circuit 

Thee miner circuit is now cm the far-right side of the schematic, with the detector circuit to its left. 
The addition of an NPN transistor allows you to drive almost as much current as you could ever want in 
the application. The current-limiting resistor R I has been dropped to 47f'l, to accommodate tire voltage 
drop across the transistor. Also, because you won t leave the Ik LED on all the time (in theory), you can 
drive it closer to the maximum rating during those times that It's on. 

R3 limits the current flowing from the AVR pin to the base of the transistor. Almost a volt drops 
across the base -emitter Junction, so you use the figures 4 V (V - 5 V less - IV. I and 40mA to arrive at iOlKt 
as the optimum value (E - 3 * R, so ft = E -r I, according to Ohm's Law) for this resistor. 

R4 is the current- limiting resistor for the IR emitter-enabled indicator. This is ju si an Indicator LED, 
so you don’t need to budget much current for it. 

Don't try connecting both the LED D3 and the transistor Q1 through the same resistor. The voltage 
at [he base of Ql won't get much over lV r so Dli will never be illuminated. Even a red LED needs closer lo 
2Vto overcome Rs forward voltage requirement. Use two resistors, each one carefully selected for 
optimum performance in this circuit. 

The adjustment circuit is a lCKfl linear potentiometer connected as a voltage divider. The CVV 
indication shows which way the wiper moves when the potentiometer's shaft Is rotated clockwise. This 
increases the voltage as the knob is turned to the right. 

The IR detector is fundamentally unchanged. A dedicated pull-up resistor, R2, is placed in the 
schematic, but you can omit it in the final circuit if the Internal pull-up within the AVR is sufficient. 

Added to the detector circuit is an Indicator LED D4, with a PNP transistor driver. Because the 
absence of IR light leaves ibis point In the circuit at approximately 5V. the emitter-base Junction of Q2 
isn't forward biased, so no current flows through the LED and its associated current-limiting resistor, R7. 
Only when the voltage drops below -4 V does the transistor begin to turn on, lighting the LED, which 
indicates that !R light is being detected. This circuit gives a nice analog response, allowing you to gauge 
how effectively the sensor is responding. 
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The resistor con meeting the photodiode to the transistor Is relatively high Lit resistance at iCJGKiL 
This prevents excessive current from flowing back through the transistor to act as more of a poll -up on 
the signal. You can use lower resistor values, but they then prevent the signal voltage from dropping all 
the way down to ground. 

This circuit can't easily be scaffolded up from the expansion connectors on a typical Ardulno, 
although you’re more than welcome to try. A more reasonable approach, or perhaps an approach with a 
more reasonable expectation of success or longevity, is to build the circuit on a solderless breadboard 
and then connect it to your Aid uino. One way to do this is Illustrated in Figure 10-6. 



Fig nr* 10-ti, The improved proximity detector built an a solderless breadboard, mop the Maker Shield. 
The clear LED i.s the ift emitter, and the black LED is. the PIN photodiode. The riwo srnali red LEDs are the 
associated indicator lights. Having these llgitts hard-wired to the circuit means they work even when your 
sketch doesn't. The Maker Shield has a built-in potentiometer that is used as she threshold adjustment. 

Only a few changes are necessary In the prototype sketch. Sec Listing 10-2. 
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Lining 10-2. Slightly Improved Software far the Improved Proximity Detector Hardware 
void setups) { 

piflM&dc(9* OUTPUT)^ if IR emitter enable 
pinM&rfe{i3, OUTPUT) j: ti LED pin 

digitalWrite(l4 P HIGH); // enable pullup on analog input AO/014 

} 

void l&opO { 

int infrared; // how much infrared: 0=n&ne > 1023= a iot 
int threshold; // adjustable comparison value 

digitaltfritef&ji HIGH); // enable infrared emitter 
threshold - 1023 - analogRead(l) ; // get threshold value 
infrared = 1023 - analegRead(O); // convert voltage 
digit alwrite(9, LOW); N disable infrared emitter 

if (infrared > threshold) { 
digitalwrite(l3j. HIGH); // LED on - lfi detected 
} else { 

digit alklrlte(l3j LOW); // LED off - no IR detected 

> 

) 


The setu p [ ) functi o a adds a state me a i to co n fig ore DB as an outp ut en able s Ignal . This allows the 
software to turn on the power- hungry emitter only when necessary. During the course of this example 
sketch, St seems to always he necessary, but your sketch wit! be smarter titan this. 

The loopQ function dee lares a couple of lnts to hold the I Ft light reading l Infrared) as well as the 
adjustable threshold setting [threshold). 

At the beginning of the loopO function, the emitter is enabled by writing a HIGH value to digital pin 
DB. To give the PIN photodiode time to react to the illumination,, the threshold-setting conversion is 
now performed, and only then Is the IR reading taken, both using the anaLogRead() function. After this, 
the IR emitter Is disabled. 

The values for both the infrared reading and Lite threshold setting are mathematically inverted by 
subtracting the actual conversion josu.lt from 1,023, the maximum reading. This effectively reverses the 
meaning of the magnitude of the values. Now a larger infrared reading means more IR, and the same 
applies for the threshold setting. Bear in mind that the threshold potentiometer could have been wired 
with the opposite polarity, with a lower voltage corresponding to a clockwise rotation of the shaft. This 
might save some precious bytes of program memory as your sketch nears 100% utilisation some day. 


Printed Circuit Boards 

As mentioned In Chapter I, there are several low-cost options to design and build your own printed 
circuit boards ! PC Bsj. Later, this chapter covers a couple of software tools to help you design your board. 
Right now, let's review a bit about bow PCBsare made, so you can start to wrap your bead around the 
design process. 

The most basic PCB typically slarts out as a sheet of nonflammable, flat material with a layer of 
copper foil attached to one side. This will be a sfngfc-sfdedfPCB when finished. This means the printed 
circuitry Is only on one side. Components can lie installed from either or both sides, although it’s more 
common for the components to be on one side (the component side) and the circuitry and soldered 
connections on the other side (the solder side). 
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PCBs with through hole parts, as opposed to surface- mo uni devices, need lots of holes drilled, along 
with any mounting holes that are required. These holes are usually drilled by a computer numerical 
control (CNC) machine at very high speeds and with amazing accuracy. The blank hoards are usually 
stacked and many hoards [front three to ten] drilled at the same time with a single drill bit. The really big 
machines have multiple drill spindles running In parallel, each drilling its own stack of PC El panels. 

Once upon a lime, not so long ago, these drilling machines used paper tape to store the data for the 
drill sizes and hole locations. You still hear people refer to drill /ties and drill tapes interchangeably. 

All the points on the PCB are electrically connected together at first, all being within the plane of the 
highly conductive copper rollon the blank PCS. To form the Individual wires and connections between 
components, the unnecessary copper is removed, usually by a chemical etching process. A pattern of 
what should stay and what should go is produced at the end of the design process [you get to that in a 
hit), and this is called the art work for the copper Layer. Typically, this artwork is printed on large 
transparent sheets [still often called plotted or photoplotted because it was once done with plotters] and 
is used in a photographic process to allow some of rhe copper to be made insensitive to the chemical 
etch (that is, converted Into etch resist) aod the remainder to be left sensitive the etching process. This 
process generally takes many steps by Itself. The board Is then etched In acid, removing the vulnerable, 
untreated copper but leaving the protected, resistant areas. 

On a si ngle- sided PCB. It almost doesn't matter If the component holes are drilled before or after the 
copper lias been etched. The production of don tie -sided PCBs, however, requires a plating process to 
connect the two sides where connections are necessary; and this must be done after the board is drilled 
hut fw/brethe board Jsetched, because the electroplating process requires a conductive path. Because 
many PCB production facilities build both single- and double-sided PCBs, the order of the processes Is 
determined by [be physical layout of the machinery in the plant, which Is often optimized for fastest 
production. 

Once drilled arid etched, a PC lit can be stuffed with components and soldered together. In most 
cases, except for extremely cost- sensitive products, two additional manufacturing steps are performed. 
This first is to coat the board with a specific pattern of snider mask, or solder resist. This layer covers the 
entire PCB except the points specifically requiring solder, such as component holes and connectors. The 
solder mask layer helps separate tightly spaced component leads and prevent shorts and solder bridges 
from forming between parts. The solder mask Is what typically gives common PCBs their green color. It 
can beany color you want, if your PCB supplier is willing it] do this for you. 

The final layer applied to a PCB Is often the silkscreea or parts legend. This is away of printing text 
such as reference designators and component values as well as part outlines and any explanatory 
information, such as part numbers. This layer is called a silkscrcen because thai Is the usual method of 
applying the contrasting Ink to the board. White ink on green solder mask Is generally the cheapest 
combination, which accounts for Its overwhelming popularity. 

After ail Lhc additional layers have been applied, some form of final plating Is done to the exposed 
copper; otherwise it would rapidly oxidize. A tin-lead mixture was until recently [he most popular 
option, but tills Is being replaced because lead is being phased out of most electronic production 
facilities (what with it being poisonous and all}. Gold Is another popular choice, not only for Us beautiful 
luster but also due to its excellent electrical properties and noble character. Gold is a member of the 
noble metals because it's naturally resistant to corrosion and oxidation and therefore makes ait excellent 
plating for electrical contacts. 

You can start to see that a Lot of different kinds of artwork and design files are required in the 
traditional manufacture of PCBs. You can also hack away the copper from a blank panel with a Dremel 
tool or an X-ACTO knife and then drill all the holes by hand. It's tedious and time-consuming, but 
sometimes that's exactly what you want in a hobby. It also gives you the freedom to put the art hack In 
artwork, if you so choose. 

In earnest, there are a lot of excellent methods for producing small batches of PCBs yourself, and the 
results very often are more personally meaningful than what can be made by a machine. 
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PCB Layout Techniques 

1 1 doesn't matter what specific manufacturing technique you use to fabricate a PCB. It needs to he well- 
designed and follow a few simple rules to work effectively as a substrate fnr your circuit. This applies 
whether you’re using state-of-the-art CAD software or masking tape with ferrous chloride. Let’s review a 
few basic tenets and see some examples of how to apply them, using your IR proximity sensor as a test 
run. 

First, give yourself some room. This applies both to your production area as well as your design. Yes. 
you can cram all the parts in as close as possible and do some tricky routing to get everything connected, 
but then you have a board that's hard to assemble and even harder to repair. Only when you begin 
getting Into production quantities of PCBs does the cost of those precious square Inches or millimeters 
outweigh the practical concerns of assembly, troubleshooting, and repair. 


Note Please design your inventions to be repairable. The world’s oceans and landfills thank you. 


Next, remember that although copper Is an excellent conductor of electricity, the copper on your 
PCB is typically quite thin. One- ounce copper cladding is a very standard thickness of copper for printed 
circuit work. This means there is one ounce of copper for every square foot of surface area [take that, 
metric system!). This equates to a typical thickness of just 0.00134" to 0.00140" of copper in your 
connections. Make those connections, called traces, as fat and wide as you possibly can. [fit still fits and 
it doesn't overlap another signal,, it’s not too fat. Two-ounce copper and half-ounce copper are also 
commonly available, with twice and half the copper thickness, respectively. 

Back to room issues. Between those fat traces are the spaces, and these need to be as hig as you can 
make them, too. The etch process isn't perfect, and sometimes it etches too much (ouejvfcJi), eating 
away at your conducting wires! and sometimes it doesn't etch enough tunderetch), possibly leaving 
visible or microscopic shorts between your signals. PCB houses will tell you up front what their 
minimum traces and spaces capabilities are. Don’t push it to the limit everywhere all the time. Give 
yourself and your PCB design plenty of room. 

PCB units are generally intended to measure pretty small tilings. Therefore, thousandths of an inch 
are called mils, which lias nothing to do with the metric system. One mil = 0.001". Get used to thinking in 
terms of mils, unless you live in France. Millimeters are also used a lot. 

Label everything possible on your hoard. If you're going to forego a proper sllkscreen, you can still 
put text In the copper layer. If you’re scratching out your boards by hand, consider typing up a label to 
stick on your hoard after It's assembled. Future generations will thank you. 

Laying out a PGB takes time, patience, and, above all, practice. Don't be afraid to start over, perhaps 
many times. Using CAD tools makes this a lot easier. 

One way to approach laying out your first few PCB designs is to imitate the layout of the schematic, 
ft's not a good wav, and It’s far from ideal, but it's relatively easy and helps tn get you started. Otherwise 
the translation from conceptual schematic to physical layout can he a hurdle too high for aspiring 
designers, and they quit. Don’t quit! Don’t he lazy! Don't be afraid to do it wrong a few times and then 
com pletely si art from scratch and do it again. 

Let's apply some of these Ideas to your IR proximity sensor. It can certainly be laid out In a compact 
and efficient manner, hut it would prove quite difficult to assemble by hand. In addition, the routing of 
all the cnnnectlons becomes much more challenging as the available room diminishes. You begin with a 
blank PCB that is two inches on a side — more than enough room to effectively place the components 
and stilE have enough room between them to easily get everything connected. 
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A First Attempt 

The components are placed on Lhe PCB in sorta-fcinda the same arrangement as the schematic. It's, not 
an absolutely faithful copy, because the physical components aren't exactly the same size as theh 
schematic symbols. A Utile nudging and playing around with the placement of the components result in 
the arrangement shown in Figure 10-7. 




Figure 10- 7. The first attempt at laying out the /i? proximity sensor on a PCS. The image on the left 
con tains the component pads, part outlines, reference designators, and component i mines, and is often 
called an assembly drawing, because it can heip in assembling the PCB. The image on the right shows the 
copper layer and component pads as well the parts outline far reference. 

Figure 10-“ shows two distinct views of the same PCB, each one offering different Information ahnut 
the hoard. These views are composites of several of the individual pieces of artwork that would be 
needed to actually huild the PCB. 

The view on the left shows a good approximation of what the blank PCJJ looks like before It's filled 
with parts and assembled. This is called an assem bly drawing and can he used as an aid to constructing 
Lhe final circuit. 

Because this Is a through-hole design, all the component leads are threaded through the board and 
soldered Into place. The excess leads are then trimmed and discarded. Each of the component leads has 
a dough nut- shaped pad surrounding the hole. Most of the pads are round, hut a few* of them are square. 
The square holes are usually there to indicate something special, such as proper part orientation when it 
matters, or the numbering of pins In a series. A square pin usually Indicates pin 1 in a series or group of 
similar pins, although this convention Is, unfortunately,, not universally adopted. 

If this board was manufactured as a single- sided PCB, It would be possible to omit the pads from the 
top side (the component sldej, leaving only the pads on the bottom (the solder side). This is because all 
the soldering would be done on tire bottom. It's generally cheaper to build a single -sided PCB than a 
double-side PCB, because there are fewer steps Involved in tire maim factoring process. 

However, a double-sided PCB can have ail tire holes plated with metal using an electroplate process 
during manufacture. This provides an electrical connection between the two sides of the board, where 
appropriate. Also, Lhe solder Joint between a component lead and the PCB itself Is much stronger, both 
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mechanically and electrically, when you use a plated -thro ugh hula versus just a pad on one side of a 
single- sided PCB. 

The coin po men t outlines, refe fence designators, and values are primed on Lite hoard using a 
silkscreen printing process. These assist in Identifying the locations of the parts for assembly, testing, 
troubleshooting, and repair. 

The border around the edge of the board defines the board's profile. This tells a machine, usually a 
high-speed CMC muter, how to cut the individual PCI! out of the panel from which it was produced. 
Alternately, it can show you approximately where to point your hacksaw. 

The Image on the right shows the same board outline, component pads, and outlines as well as tire 
identifying label announcing 3R PROXIMITY SENSOR. These Items are shown only for reference; the 
main tiling you need to look at In this image is the copper pattern. This pattern, In conjunction with the 
component pads, forms the traces and spaces of the circuitry that remain after the unneeded copper Js 
removed in the etch process. The bulk of the traces will be covered by the snider mask layer, if applied, 
leaving only the component pads exposed. These component pads should be plated lo prevent the 
inevitable oxidation of the copper material. 

Here's an Important concept to understand right now and never forget. The copper layer describes 
the bottom side of this particular ECU. However, you're wo/ looking at the backside of the board. The 
convention with all PCD artwork is that you're looking through the PCB as If It were semitransparent. 
That way, when it comes time to plot the individual artwork layers, everyone is on the same page and 
can align everything properly. 


Note You Ye always looking through the PCB artwork, from the top to the bottom. 


Because these components are spaced so far apart, and there is so much room between the 
component leads, it wasn't difficult to route all the traces on a single side of the PCB. On a tighter design, 
it might have been necessary to route some of the wires on the top as well as the bottom. 

On especially tricky signals, it's sometimes necessary to start out on one side of the hoard but end 
up on another by travelling through a ojyj, or extra plated-th rough hole added to facilitate a wiring 
connection. Once upon a time, and possibly even today, you would he charged extra for each hole or via 
contained in your design. Today, most PCB s are priced according to the number of layers and total 
surface area, excluding any special services you want, such as purple solder mask or gold plating. 

Notice that all the traces are nice and fai (O.DSfl" wide, or SO mils, to be exact! with plenty of open 
spaces between traces and component pads. Because tills layout mimics the schematic, most of the 
wiring connections are relatively short. This resulled, however, in all the best routes being taken early, 
leaving a couple of traces to have to wander all over the hoard to find their ways home. 

Overall, this isn't a bird PCB layout, li could easily be manufactured at home or at a professional PCB 
fabrication facility. Being a little on the large side is a big plus when building prototypes. The only real 
drawback to this design Is that the 1R LED and the PIN photodiode aren't physically close to each other, 
which would normally he a desired arrangement. Of course, there’s no reason the two optoelectronic 
parts couldn't be mounted off-board by extending the component Leads with wires. Then you could 
place the two parts wherever you wanted in relation to each other 


A More Compact Version 

Let's take a quick look at a slightly more compact version of the same circuit. See Figure 10 -ft. 
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Figure 10- 8, A more compact version of the IR proximity sensor. showing assembly drawing ( (eft h top 
copper layer (center), and bottom copper layer (right i 


Again you have an assembly drawing that shows the relative positions of the components along with 
their reference designators arid, component values. Due to the lack of wide-open spaces, some of the 
traces were routed on the top side and some were routed on the bottom side. 

The power and ground connections are made using copper poods or ground planes. These are the 
dark areas in the artwork. The top ground plane Is actually the signal. The ground plane on the 
bottom side Is the ground signal. The component leads that attach to these two signals, or nets, are 
connected with up to four small traces, radiating from the center of the pad. The extra space around the 
pad is called a thermal relief If the pads became pari of the Earger plane, it would be very difficult to 
solder, because the ground plane Is made of copper, which Is an excel lent rfrerrarif conductor as well as 
ait electrical conductor. The pads that do not attach to the ground planes have a smalt relief around 
them as welt to electrically Isolate them from the copper flood. 

All signals on a PCD are called nets k even if they connect only two points. A net list is a listing of all 
the connections between all the components on a PCB. 

This more compact version of the IR proximity sensor is less than half the size of the previous 
version (i.tit'J" * G.9Cf to he precise) and could he made even smaller by using surface- mount dev Ices 
instead of through-hole components. Two mounting holes have been eliminated, hut they would most 
EikoEy not he needed for such a small hoard. All the pan labels and Identifying marks are retained. The 
profile of the PC 11 now uses rounded corners. 

The main difference, besides the size shrinkage, Is that the IR LCD and photodiode are now side by 
side at the end of the PCB. In actual usage, there could he IR light leakage between the two, when you 
want to measure the refected I Ft returning from an obstacle or target. This can be minimized by Inserting 
an opaque harrier between the two devices or Installing a shroud of black heat-shrink tubing around one 
component or the other. 

Also note that the compact version of the PCB hears little resemblance to the original schematic, as 
far as the placement of the components is concerned. That's OK. The two designs express the same Ideas 
hut with different Intentions and applications. 


Making the Connection 

I Low do you connect this sensor to an Ardul.no? No specific connector is identified In either the 
schematic or the PCB designs. Right now it's just a line of holes In the PCB. with each hole spaced 1 1 1> ' 
(LOO mils) from the next. Pin 1 Is Indicated by the square pad, and the rest have round pads. 

You could solder in a female header, similar to the expansion connectors on the ArduJno. Then you 
could Install jumper wires between the module and the ArduJno. 

You could Just as easily solder wires directly to the board and then stuff the other ends of those wires 
into your Ardulno's expansion connectors. That would work until anything moved. 

Another option Is to rearrange the Interface pins to directly correspond with The expansion 
connectors on your Ardulno. This could he the basis for an entire Arduino shield or a tying; that Is. a 
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module that plugs into only one or two of the expansion connectors and doesn't entirely cover for 
shield} the Arduino I/O Board. Such a design in presented in Figure 10-9. 





Figure 10-5. A« Arduino wing tha i holds the IR proximity sensor. The assembly drawing is on rite left , 
illustrating tlte component layout. The top copper layer is tn the center. The bottom copper layer is on the 
right. 

Again you have an assembly drawing, showing the relative positions of all the components. The 
center Image Is the top copper layer, again with a copper flood that constitutes the V, , net. The linage on 
the right is the bottom copper layer with its ground plane. Header pins can lie soldered to the bottom of 
ibis wing design, allowing the hoard to he directly Installed on the bottom two expansion connectors 
(POWER and ANALOG) of the Ardu ino I/O Board. 

Analog pin AO is the analog voltage Input that Inversely corresponds to the amount of IR light 
detected. Analog pin A 1 must now he used as a digital output and becomes the 3R emitter enable output. 
Analog Input A2 can serve as the threshold setting Input. 

A partial connector outline on the sllkscreen layer helps the user align tire wing properly when 
plugging it Into the Arduino. All Lire components are labeled with their reference designators and values. 

An entire Arduino shield devoted to a single IR proximity sensor might be considered overkill, hut 
it s certainly possible. A six-channel IR proximity sensor, on the other hand, might be useful for a mobile 
robot that needs to see In several directions at the saute time. 

You come back to litis simple circuit later in lire book. 


Your Own Custom Arduino 

It’s not a big jump to go from designing your own Arduino shield to designing your own Arduino I/O 
Board. There's a lot of flexibility In what can properly he called an Arduino -compatible device. Pick the 
processor you want to use, slap on the parts it needs, and then decide what other ingredients you want 
on your p i x i ta Arduino. 

You need to make several design decisions along the way. These include compatibility with existing 
Arduinosand shields, power-supply options, processor selection, and additional circuitry. Let's look at 
each of these areas In a little detail, so you can get on your way to making your own Arduino, 


Compatibility with Existing Arduinos and Shields 

You should think about this topic first, because it will affect how you begin your design. You're 
completely free to go in your own direction when building an Arduino-compatible device, hut having 
some initial design goals helps in the decision-making process down the road. Also, a clear set of design 
goals lets you know when you're finished, which can get somewhat blurry as projects roll on and on. 


247 





Chapter i o mar dware design 


Hardware Compatibility 

]fymi want to maintain even a modest amount of physical compatibility with the Ardulno family, then 
you can use the existing design files made available by the Arduino Team. Go to the Ardulno Hardware 
web page (http: //arduino. cc/en/Main/Harduare) and pick which Ardulno model you'd like to emulate, 
or ihe one that best suits your needs. You can even take a trip into the past and choose from one of the 
older Ardulno models, if that more closely resembles your design target. Look at the Arduino Hardware 
Index a t http://aiduino.ee/enyMain/6oards, and download the schematics and EAGLE files. You cover 
the EAGLE CAD software Eater In this chapter. 

If you start with one of the existing Arduino designs, try to keep the expansion connectors and 
mounting holes in the same location. Leaving the hoard profile intact also makes your PCB more readily 
identifiable as an Ardulno-compatlble device. This ensures at least physical compatibility for the wide 
variety of shields that are already out there. If you know positively that you won't want to add any shields 
to your board, then you can eliminate the expansion connectors and mounting holes. 

The locations of the USB connector and the power jack are problematic. These two com portents are 
taller than the expansion headers and protrude vertically front the PCB. The standard full-size B 
connector on official Arduino I/O Boards has a metal case ihat will short against arty circuitry on an 
installed shield. Most shield designers know about this and leave that area free of exposed circuitry. If 
you move your USB connector (assuming you’re using a USB connector], you may possibly run Into this 
problem In the future. 


Software Compatibly 

hi addition to mechanical and form-factor compatibility, there are also Issues of software compatibility. 
Will your new Arduino be programmable using the standard Arduino software? If so. you need to make 
provision for a bootloader. This Includes not only being able to program the bootloader into a blank 
AVR, but also the circuitry required to activate and talk to the bootloader during normal operation. 

The traditional Ardulno bootloader operates over the serial port. It uses theTX and RX pins to 
communicate back and forth between the host PC, where the sketch is being written, debugged, and 
compiled, and the target device, which is the processor on board your Arduino DO Board. It aiso uses 
one of the traditional serial- port handshaking Lines, data terminal ready (DTR) to induce a reset pulse on 
the AVR chip. The DTR signal is normally capacltiwly coupled to the - RESET line so that only changes In 
the DTR line cause a reset, thus preventing the DTR line from keeping the AVR chip held In a reset state. 
This restarts the chip, which is supposed to be configured to automatically start running the bootloader 
code. At this point, the host PC and the target device should have a nice little conversation, usually about 
uploading a new sketch. If no conversation ensues, the chip begins executing the previously uploaded 
sketch. If any. 

All the serial interface lines— TX, RX, and DTR— must be at TTL- compatible voltage Levels by the 
time they arrive at the AVR chip. This is taken care of automatically when using the traditional FTDI 
USB-TTL Interface chip or the recently adopted Atmel ATmegaflU2 microcontroller with USB interface. 

You can omit the serial or USB Interface on your design if you provide some other method of talking 
to the bootloader. One popular solution is to leave the actual USB interface entirely off-board and only 
make provision fora programming header on the board. This allows the USB circuitry to be planted on a 
removable cable and Installed only when needed, thus saving the cost and PCB real estate that would 
otherwise be committed to each Ardulno -com pat Lhte controller. 
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Power Supply Options 

AH electronic devices need power. You have to make some provision for getting this power to your 
hoard, arid making sure it’s of the right flavor and color. Not only do you have to provide more titan 
enough power for the processor and related circuitry, Stui you also need to make some allowance for any 
devices that may attach to your .Arduino. 

If you don't know exactly how you want to power your new design* then copy the existing Ardulno 
power -supply circuit. It's OK. You already have the company's blessing to do so. The existing Ardulno 
power- supply design lias evolved over several generations of Arduino models. In fact, it could very well 
he the most evolved aspect of the entire Arduino project. It has multiple in put -connector options and 
gracefully handles both regulated and unregulated voltage supplies, it even handles Itself well under had 
circumstances, utilizing components that intentionally shut themselves down under adverse conditions. 

if you already have a good idea of what your power-supply options are, then go ahead and design 
them into your board, it's always a good idea, however, to allow for a potential Plan B scenario, even if 
it's Just an extra set of power terminals somewhere in the mix. 

Both the ATmega326and the ATmega256G microcontrollers require a regulated 5V supply to run at 
or near their maximum clock rates. A good design practice Is to place one or more large fitter capacitors 
somewhere either near the on -hoard voltage regulator (If used) or near where the power enters the PCB. 
A ‘IT'jjF capacitor is deemed sufficient by the Arduino Team for their hoards, hut a tittle more won t hurt 
and probably won't cost most, either. Also place at least one smaller capacitor* U.luF or so. near each of 
the power pins of the microcontroller device and any other component that uses or switches any 
significant amount of current. This will prevent spurious glitches on your supply husses that could Eead 
to erratic behavior* it's also a good idea to add some of these smaller capacitors at any point where 
power ejrfts your hoard. 


Processor Selection 

You can use any microcontroller you want — really you can. If you choose one of the microcontrollers 
that have already been used in one of the official Ardulno I/O Boards, then you can use the existing 
bootloader firmware and library cores ihat have already been written and tested. 

Nobody says you have to use an Atmel AVR. That's been the trend out of Italy* but then again they're 
consensus builders and are working hard to make it easier for everyone to get up and running with the 
Arduino. If you're a rebel and want to drop a Socket 7 processor into the mix* go ahead, blaze thaL trail! 
Be a dear and drop you a note when you get there. 

Generally speaking, your processor selection is mostly determined by your required pin count, 
livery member of the AVR family is based on the same CPU core, from the teeniest AT tiny to the most 
monstrous ATmega. 

Atmel also manufactures a broad line of ARM-based, 32-bh microcontrollers. The Netduino Is 
produced by Secret Labs LLC iWn-metdolno *com] and features the AT91SAM7X, a 4 6MHz 
microcontroller with 128 KB of program memory and 80KB of SRAM. The Netduino is compatible with 
the .MET Micro Framework, which means you can develop applications for at JnG# using Microsoft's 
Visual O Express 20 10. So don't think you're fenced in by the selection of available AVR devices. 

After pin count, available program space Is most likely the next major criterion In processor 
selection. The original Ardulnos bad the ATmegafi processor and Its 8KB of program memory, and many 
interesting aatd exciting projects were launched with It. The 32KB program memory of the current 
ATmega 328 device is ample for most small applications, but Li’s certainly possible to use It ait up once 
your project develops a few features. 
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The monster ATmega2560 installed on the Arduino Mega 2560 has both the largest program 
memory (2 56 KB) and [he Larges! pin count ai I Of) pins. If you need more than that, you have to look 
elsewhere. 

You should give serious consideration to providing an In-System Programming (ISP) header for the 
main processor on your board, assuming you're staying within the AVR family of devices. Doing so 
allows you to program blank, factory-fresh processors using the correct device-programming hardware. 
This step Lsn'l optional unless you're planning to either huy the parts already programmed and properly 
configured or have some other mechanism in place for programming the parts before installing them hi 
your new hoard. Even if you don't think you need ait ISP header for the traditional reasons {bootloader 
burning and so on], it can also serve as a debug port If you happen to have the rigbi hardware (AVR 
Dragon, JTAGICE mklll and software (AVR Studio, avarice), allowing you to both program and debug 
your application with access to individual registers and memory locations at runtime. You can even 
single-step your program through the source code or machine- language Instructions, checking that 
it’s meticulously doing your bidding at every step. Include that little six-pin header in your design even 
if you don’t think you'll ever use it. You don’t have to actually Install the pins, but it's nice to know 
you can. 


Anything Else? 

What makes j^nur Arduino special? Why are you going to the trouble and expense of designing your own? 
Here is the hest part about designing your own Arduino from scratch: It can literally he anything you 
want it to he. 

It can he spartan! y simple or bizarrely complex. For the utmost in simplicity, strip out everything 
nonessential and stick in the bare minimum. See Figure 10-10. 



Figure 10-10. A breadboard At d id no circuit with removable USB adapter. This is perhaps the least of all 
possible A rduitios, but someone will probably pad a way to do it with less. 

Bear In mind that you ean design a very complex circuit but then only populate the parts you need 
at the time. See Figure 10-11. 
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Figure 16-tJ. A partially populated Arduino Duemilanow PCB with only the minimal parts required for 
USB support This prototype was used In She digital clack example project In Chapter 7. 

There's an old saying that some hold to be [rue: never build what yon tan buy. Or was it rhe other 
way around? 


Design Software 

You don't have to use a computer and software to design electronic devices, but iL does make it more 
challenging to do so. The tools at your disposal are a very personal choice. Use what works for you. On 
the other hand, keep an open mind when it comes to the tools you select for a cask. Invest some time In 
learning more about the tools you already have, and don't be afraid to try new tools as well. Sometimes 
seeing how others fall is a great motivator. 

There are more computer-aided design (CAD} tools available for designing PCB s than there are 
pages in [bis book, with more popping up every day. Let’s look at fust one of them, which has a special 
link to the Arduino project. Feel free to try this and many other tools on your Journey. 


CadSoft EAGLE 

The Arduino was designed and documented using the popular electronic design automation (EDA} 
software EAGLE from CadSoft (www.cadsof tasa.comj. EAGLE is an acronym meaning Easily Applicable 
Graphical Layout Editor, so technically It should always be written using capital letters. 

EAGLE Is proprietary software available for Microsoft Windows. Linux, and Mac. CadSoft offers a 
variety of end-user licenses, ranging from a free, limited version (the EAGLE Light Edition] for nonprofit 
nr evaluation purposes to full Professional licenses with various numbers of users. 

All versions of EAGLE have three main modules. The Schematic module lets you draw your circuit 
and make a very nice-looking document to share. The Layout Editor module lets you convert your 
schematic to a PCB layout and generate the Industry-standard files necessary to have your PCBs 
manufactured. There Isa back-ami -forth connection between the. schematic and the PCB layout editor, 
allowing you to hack annotate your design from cither program. The Autorouter module attempts to 
connect all the parts In your circuit using wires on Lho PCB layout* which is very Interesting to watch. 
You can also route the traces (wires) on your PCB by band. 
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Parts are defined using a library editor to define botli the schematic symbol and the PCI1 footprint, 
as well as rite relationship between the two. The standard EAGLE library comes with thousands of 
predefined parts. You can also define your own parts and share your library with other EAGLE users. 

EAGLE also supports its own scripting language, which can automate many tasks. An example of 
what you can do with the scripting language is EAGLE3D .matwei .de/doku . 

php?id=en: eaglet d: eaglet dj by Matthias VVelEer, a three-dimensional rendering script that takes your 
PCR layout and generates a script that can he interpreted by the open source program Persistence of 
Vision Hay t racer fPOV-Ray, ww* „ povray , orgj, also available for Windows, Mac OS/ Mac OS X, and JB6 
Linux. Really nice images can he generated. See Matthias's web site for several good examples. 

EAGLE lias a hit of a learning curve, but it isn't too terribly difficult. There are, at last count, a 
bajiJLIJon tutorials available online for learning EAGLE. 


EAGLE Tips 

The free-of-cost version of EAGLE limits you to a single sheet for drawing (what the industry calls 
cup In ring) the schematic diagram of your circuit. Luckily, you can make this one sheet as big as you 
want. 

Try to keep your schematics logically organized. Feel free to add nutes to j cm hid yourself of any 
interesting nr non- obvious aspects of your design. Just as with the PCB layout, don't try to cram 
everything as close together as possible. Use some of that whitespace. 

You can name everything on your schematic, both the parts and the connections between them. 

You can make these labels visible or not. Every component can also have a value. For some components, 
ibis doesn't make senses and for others, a single value isn't enough. You can always add additional text 
to the schematic, but It won't be associated with any particular part as the name and value are. 

When you move a part, ihe name and value move with It. You can adjust the placement of the name 
and value, hut only after you smash the part, The name and value still move with the part If the part is 
subsequently moved. 

Parts in EAGLE come from a parts library. Thousands of parts are included, grouped Into distinct 
libraries, and many more are available nnline. You're strongly encouraged to learn to make your own 
parts from scratch. 

To make your own parts, you must understand the relationship between a schematic symbol, a 
physical package, and the possible connections between them. Many components are available In 
different packages, and EAGLE accommodates tills well. Again, you're encouraged to master the creation 
nf new pans from scratch, because doing so liberates you from the limitations of Ihe existing libraries. 
There's always one part you need that’s either not available or not np to your standards. 

EAGLE offers direct-to-PDF printing options, making it easy to share your designs across many 
platforms. You can also create Image files directly from the screen. Always create your distributable 
content in monochrome (black and white). It's much easier to read both on a com puter screen and hi 
print. 

You can use EAGLE to generate artwork directly on a printer, using either toner- transfer paper nr 
transparency material. 

To have your PCB professionally produced, EAGLE also lias a very sophisticated facility for 
exporting Industry- standard production files. The best way to learn how to do this Is to contact your PCB 
fab and ask what formats it can accept. Generally these are Gerber files for the layer artwork and 
Excetlon dtlll files for the holes. Each PGB house has Its own preferences for how these files should be 
formatted and named. Some services accept EAGLE files directly, which saves you time and perhaps 
helps avoid file-translation problems. 
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Summary 

]ust enough to gel you interested, but not enough to do it for you: that was the goal of this chapter. 
Designing your own circuits [or borrowing [hem from others) Isa wonderfully en gaging activity. it pulls 
in several different parts of your brain and makes them cooperate to achieve the goal. This gives some 
people headaches. Other people get great Ideas. 

A circuit can he as simple or as complex as you need It to be. Start simple, prove what works, and try 
in understand why. Then move on to more complex designs. And repeat. Always repeat. Build your skill 
set r and you build yourself. 

Now that you’ve got a good idea about the hard stuff, let's dive deep Into some of that soft stuff in 
the next chapter. How hard could it be? 
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By now you've developed an appreciation of how much software is involved In the Arduino 
phenomenon. It's everywhere! Let's take a quick look at some of the more advanced things you ean do 
with the existing Arduino software, such as creating your own Arduino libraries bind targeting alternate 
cores (that is, something other than the ATmega32fl or the ATinega256Q). Then you look at some of the 
tools you can use to augment or replace the Arduino software infrastructure. 


Advanced Topics Within Arduino 

The first part of litis chapter Is devoted to a couple of semi advanced software topics that fit squarely 
within the Arduino software's domain. 

You can develop very modularized code with Arduino by utilizing Lis version of a library system. You 
design your software widget to perform a particular task or range of tasks, conceal all the "how" deep 
inside your library, and expose only the high-level functions needed to interact with the library’s 
functionality. 

If ynu r d Like to use the Arduino software environment with an AVR chip that hasn't traditionally 
been supported, you ean certainly do so, by writing your own core files to support it. This chapter 
examines in detail an example of how to write programs for the diminutive and inexpensive ATtinylSA 
using the Arduino environment. 


Writing Arduino Libraries 

Arduino libraries are distributed In a different format than, say, Lite avr-libc library. Arduino libraries 
coo sis t of un compiled source code and header files, with optional keyword definitions and example 
sketches. Let's go through the process of setting up a simple Arduino library. Once Installed in the 
correct location, your new library' and associated examples should he accessible from within the Arduino 
IDE. 

Arduino libraries often Implement objects, using C++ techniques. For those seasoned C++ 
developers out there, this makes perfect sense, and there will be murmurs of "hut of course" and. "how 
else?" For the rest of the C-loving world, and those still learning C++, this can serve as a very limited 
introduction to object-oriented programming (OOP). If the deep, dark secrets of C++ don't Interest you, 
you can skip the explanations, but you still need to comply with the methodology outlined If you want to 
create or even effectively use Arduino libraries. 

In ease you’re wondering, everything else you've been doing so far in these example sketches falls 
under the category of procedural programming. You've been instructing the Arduino to 1] do this, 2] do 
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that, and 3) do [his other thing, outlining a procedure for manipulating data and performing predefined 
actions. It's certainly easier to follow and understand, and makes for better example sketches. Real-life 
applications, however, may be different. 

OOP, on the other band, focuses on objects, which are abstract collections of associated data and 
functions. There are some decided advantages to the object paradigm, including encapsulation, 
inheritance, and possibly polymorphism, but you don't need to get into all [hat right now. Here you 
approach the writing of Arduino libraries and its brush with OOP In the traditional, time-tested Arduino 
way: by blinking an LED. 


A Trivial Example Arduino Library: LED 

A few words about how theArdul.no software provides support for libraries are In order. Within tire file 
folder hierarchy of the Arduino software installation is a folder called libraries. In this file folder, also 
known as a subdirectory, Isa collection of even more folders. The.se folders bear a striking resemblance 
to the menu items found in the Arduino software, specifically the Sketch > Import Library menu item. 
You should also find the same list at the bottom of the Pile > Examples menu. Your new LED library will 
appear In these places as well, after you've placed the files for the Library in the right place. 

YouTtcall your neiv library LED. Create a file folder named LED in the Libraries folder of the Arduino 
installation. When you reslart the Arduino software, this new Library appears in the Sketch > Import 
Library menu hut, oddly enough, nor in the File > Examples menu. You can even click the LED menu 
item in the Sketch ► Import Library menu item, hut nothing happens, because there is no header file to 
import (yet), 

Ai a minimum, you need to create two new fLies for your library. The first file Is the source code for 
the actual implementation of the library functions. This file must have the specific C++ source file 
extension .cpp. You can't use the old .pile or the new . ino file extension used for sketches. Make sure 
your editor doesn’t automatically append an extension for you, such as .txt. You can’t use the Arduino 
code editor to write these files, because u wants to protect you from making file-naming errors, such as 
using the ,cpp extension. 


The Library Header File LED.fo 

The other file you need to create Is a header file with a . h file extension. The header file Is where you 
store tiie definitions needed lo use the library In your sketches. For the purposes of this admittedly brief 
introduction, call the header file LED. h. In reality, you can name your header file anything you want. The 
Sketch > Import Library menu Item adds references to all header files contained in the library folder you 
choose. 

Your library 's header file should, in turn, include the Arduino, h header file. This header file defines 
all the built-in Arduino -specific functions that are normally needed in a sketch. The Arduino software 
includes this file for you automatically when compiling a regular sketch, but not for a library. 

In previous versions of the Arduino software, the Arduino. h file was called Program. h. It was 
inherited, as were many Arduino details, from the Wiring project. This change in header file names will 
cause a problem for users of your library who are running Arduino OD22 or older. To support users who 
haven't yet transitioned to the Arduino 1.0 software, you can Include a conditional preprocessor 
directive that examines the ARDUINO symbol that Is included on the command line sent to die compiler. Et 
ends up looking something like this: 
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Sif AftDUINQ ^ 100 
ffinclude cWPi'ograft.hi* 

Pel sc 

((include <Ardulno.h> 

Sendif 

If the Arduino software version is less than 100 (supposedly Indicating LQO; cider releases such as 
0022 were assigned a value of 22}, then the older iWProgra^.h file is Included. If the software is version 1.0 
or later, the newer Arduino.h file is Included. If you plan to release or share your libraries with others, at 
least for the next year or so (not everyone upgrades as soon as a new version is released] , then please 
consider adding tills workaround to your library header files. 

You can also use this type of check in the future if you want your code to be able to tell what version 
of the Arduino software Is being used. This can come In handy when you want to use a new feature or 
need to provide a workaround solution as just outlined. 

After this, add the definition of the library's object class. A C++ class is simitar, In a very broad way, 
to a compound data type that can hold both functions, known as methods, and data, referred to as 
mem Iters. 

The class definition can have both public and prunin' parts. The public parts are visible to all parts of 
your sketch. You want the principle methods to be public, for example, while hiding the Internal 
variables by declaring them of private scope. Or tire exact opposite — it depends on your object's 
purpose. Let's outline a simple class to start; feel free to go crazy with it Eater. 

The first items listed in a class definition are private by default. You can add an additional private: 
heading Eater In the definition if you need to mix the private and public parts. 

As mentioned, a class can contain methods that are peculiar to It. One special method is called a 
eottsmxeror. If defined, it's called when a new instance of a class is created. You can have more than one 
constructor fora class as long as they all have a different signature — that is. a different combination of 
parameters or types of parameters. For example, you could have a constructor that took no parameters 
as well as one that took a by te parameter. The com pller can tell them apart by the nu in her or type of 
parameters given, and you can define different methods depending on how the constructor gets called. 

Let's take a stab at defining your class now. It looks something like this: 

class LED { 

byte _pin; // the pin number 

byte _state; // the state of the LEI>: HIGH or LOW 

public: 

LED(byte pin); // the constructor 

void on£); 

void off (}; 

void togglcQ; 

byte stateO; 

}; 


In the public section of the class definition, you see prototypes of five functions. The first function ls 
considered a constructor because it shares the name of the class, LED. You declare only one type of 
constructor In this example, but you can create as many as you like, as tong as they all have different 
numbers or types of parameters. The constructor function ls special in that It doesn't specify a return 
type. 

The other functions define code that you'll write in the implementation phase, w hich properly 
belong in the LED. epp file. You can probably guess wh at they do. 

You wrap up the header file l>y enclosing It within a conditional compiler directive to prevent 
recursive inclusion. Wow, that's a mouthful; say that three times fast. You do this by checking to see If a 
compiler symbol named LEDJi has already been defined. The Sifndef is super-short for "if not defined." 
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It shouldn't be, unless this header file lias been included somewhere upstream. It shouldn't be, and by 
making this check you prevent it from being duplicated. 

if the symbol JnsinYbeen defined, then you define it: 3 define LED_b. Then comes the actual class 
definition, and then Lbe close of the compiler conditional statement, ffendif. There's not that much to 
the library header file at this point. Listing 1 1-1 shows what it ought to took like, unless you've already 
started taking liberties. 

Listing il l. LED Example Lihrary Header File, LED.h 

// LED.h - Example Library for manipulating LEDs - public detain 

Sifndef LE0_h 
Sdefine LED_h 

3 if AKDlllNO < 10D 
SincLude cHProgra*. h> 
flelse 

Sinclude cArduino .ti> 

Send if 

cLass LED { 

byte _pin; // the pin number 

byte _state; // the state of the LED: HlDHUon, LDW=off 

public: 

LED(byte pin); // the constructor 

void on(); H turn the LED on 

void off ( } ; // turn the LED off 

void toggleO; U toggle the LED 

byte state [); // return the current state of the LED 

}; 

Send if 


The Library Implementation File LED.cpp 

The implementation source code file is where ail the code lives. Again, name this example File LED.cpp to 
keep things simple. You start out with the library’s own header File, LED .h. Note that the Arduino . h file is 
surrounded by angle brackets fin [be library header Fiie.1 whereas [be library header file LED.h gels double 
quotes in the implementation file. The angle brackets tell the compiler [o look in the designated location 
for system header files, and the double quotes tell it to look in the same subdirectory as the current 
source file. 

Because the library implementation file includes the library header file, and the library header File 
includes the Arduino. h file, you ean use the built-in Arduino functions in tire implementation Fite 
without having to explicitly include the Arduino. h file. 

Now you ean define ail of your class's methods, and you're finished. Listing 11-2 shows what a first 
version oF the LEi ID library's source code might look tike. 
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Liming 11-2. Implementation File (Source Code) for the Example LED Library 
// LED.cpp - ExaapLe Library to manipulate LEDs - public d&sain 
S include "LED.h" 


// the constructor 


LED :iLED{ byte pin) { 

_pin = pin; // save the pin number 
pinModeCpiiij, OuTPul); // configure pin as output 


} 


// the public methods 


void LED: :cn( ) { 

digitalwrite(_pln j HIGH); // turn on LED 
_state =■ HIGH; 

} 

void LED: :Off () { 

digitalWrite(_pln J LOW); // turn off LED 
state « LOW; 

} 


void 


} 


LED: : toggle{ ) { 
if{_state) { 
off(); 

} else { 

on(); 

} 


byte L£D::state() { 

return _state; 

} 

Let's begin by looking at the constructor. As you can see, class constructors in C++ classes don't 
have return values, so you skip that pari of the definition. In a standard C program (not C++), you would 
always specify a return value, even if it was void. 

Your constructor is called LED: ;LED{). Tire first part Is the name of the cl ass (LED), the middle part 
(double colons] is the scope- resolution operator, and the last part Is the name of the function, because 
ibe name of the function is the same as the name of the class, this tells the compiler that this is the 
class's constructor. As mentioned previously, there can he zero or more constructors, depending on how 
many different ways you need to he able to create these ob jects and what needs to happen when they're 
created. 

In your example constructor, a single byte parameter named pin ls passed to the function, 
indicating the pin that is connected to the LED you want to control. In this constructor, you stash the 
value of the incoming parameter into a private variable named _pin. Prefixing private members with an 
underscore is a convention to help you remember who can see what, and when. The pin in question 
then gets configured to be an OUTPUT using thepinMode() function, although by now you may know some 
other ways to do this. 
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The remainder of the functions. In the class definition are public in scope, m can Lng they can at] he 
called directly from your sketches. 


Using the LED Library 

Let's rewrite your good friend Blink in use this new LED library. See Listing 11 -3. 

Liitltig, U-J. Blink Example SketcKRewrttten to Use the LED Library 
Sinclude eLED,h> 

LED Led (13); if assign digital pin 13 to an LED 

void setup() { 

} 

void .LoopO { 

Led. on{); 
delay (1000); 

Led. off 0; 
delay t 1000 ); 

} 


The first thing you have to do, in order to use the new LED library, Is to add the ^Include tLED .h> 
compiler directive to the beginning of your sketch. You can either type this by hand or choose Sketch > 
Import Library >- LED. If you’ve placed at least the LED.h file in tire LED subdirectory of the Arduino 
libraries folder, the menu Item method should work. If you've done that, but the LED library doesn't 
appear in the menu, you must restart the Ardulno software. 

To Instantiate (that is, create an instance of] an LED object, you declare it like any other data type. 
The data type of your LED class is LED, and you declare an object of type LED with the statement LED 
lcd{L3};. This prompts the compiler to Insert a call to the cEass constructor. You’ve defined only one. 
and it takes a single byte parameter to indicate which pin to use. Tills parameter is passed to the 
constructor, and. the code in the constructor is executed. In this simple example, ail it does is configure 
the indicated pin as an output and remember the pin number by storing it in a private variable. 

Here are some interesting facts about how classes are bandied in C++. First, because your object 
declaration is global In scope (that is. not in any particular function), the object is created even before 
the setupO function is called. If you had declared the LED object in the setup{) function, for example, it 
wouldn't have been visible in the LoopO function. Additionally, you can declare more than one LED 
object and assign different pins to them. You need 10 give them different names, of course. Each object 
automatically has memory allocated for all the private variables, but only one copy of each method is 
generated. 

The setupU function is empty because alt the Initialization you need for this sketch is performed by 
ibe class constructor, which is called when you instantiated the class. 

In the leapt) function, you see the syntax used for invoking the object's methods. In this simple 
example, you see live LED being turned on by the led . on{ ) ; statement and turned off again by the 
Icd-offO; statement. 

You don't have to teil It which pin to use. because the object knows best and remembers which pin 
you specified when it was cnnsiructed. The object name Is led, the period is ibe member of operator, 
and both on() and Qff() are public methods defined in the class. You already know how the delayO 
function works. 
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You can also make- things a link- fancier by using that toggLeO Function anti changing the delay 
times based on the state of the LED. See Listing 1 J -4. 

lifting U-4. Slightly More Complex Version of Blink, Using the LED Library 
Sinclude cLED.h> 

LEO led(l3)| // assign digital gin 1J to an LED 

void setups { 

} 

void loopt) { 
led.toggleQ; 

if (led.stateO) { 

delay ( 1000 ); 

} else { 
delay (250); 

> 

} 


The library header file remains included, as does the object declaration. The selupt) function 
remains empty. It’s only in tire lc?op() function that you see any changes. 

First, notice that neither the led.on() nor the Led. off () method Is called. Instead, you use a single 
lod.togglcQ method call to invert the present state of Lire LED. The taggLe{) function uses the private 
_state variable to decide whether to turn on or turn off the LED. The_state variable is updated 
whenever the state changes, which for now Is only when either lire an () or off{) method Is invoked. 

The led.stateO function returns the present state of the LED, either HIGH or LOW. because HIGH 
corresponds to a one and LOV corresponds to a zero, you can use C r s true/false mechanism In a 
conditional statement to direct the flow of the program. The condensed if (led.stateO) is equivalent to 
if ( led .state 0 == H LGH ) . I n this exam pic , j f the LED Is o in th en a o n e-second dcla y J s st ated. 1 f the LED 
is off, only a quarter- second delay is performed. 

You can just as easily define functions named led.isOnQ and led. isOff Q for the LED library if you 
think that reads better. Each would return a true value If Its named condition applied. 

Obviously, you could apply many optimizations to this trivial example. For example, the state of the 
LED could easily he determined by Inspecting the appropriate bit In the 3/0 port assigned to the LED; 
this approach wouldn't require a_state variable to be allocated and maintained. You also know a better 
w ay to to ggle 1 1 0 i i n es ( sec C ha pte r 6] . The pi n.Hode ( ) d Igita lVr ite ( ) „ and d ig ita IRea d Q fu notions can 
all be replaced with smaller, faster alternatives. And the list goes on. 


Providing Sample Sketches for Your Library 

If you'd like to include some sample sketches, illustrating the use of your shiny new library, you can 
include them In an examples folder In the libraries folder. If you do so. they appear In the File > 
Examples menu. It’s always a good idea to provide simple examples that show how to use a library or at 
least get started. 


261 


Chapter i i software design 


Recognizing New Library Keywords 

To fully Integrate vour library Into the Arduinn environment* you east also supply an optional 
keywords. t*t file that describes tire new words, your library adds to the Ardulno’s vocabulary. You see 
ibis reflected isi the color-coded syntax highlighting done by the Arduino code editor. 

The code editor differentiates words it recognizes* such as data types* functions, and constants, with 
different colors and the use of bold fonts. You specify these items, one per line, in a plain -text file called 
keywords, txt that resides in the same folder as your library header and implementation files. Listing 11- 
5 shows an example of what your keywords . txt file should look like. 

11-5. keywords, txt File 

LED KEYWORD 

cm KEYWORDS 

off KEYWORD! 

toggLe KEYWORD! 

state REWORD! 

Each line defines a single keyword. The line starts with the keyword, then a tab [not spaces), and 
then either KEYW0R.D1 for user-defined data types and classes, KEYWORD! for methods and functions* or 
LITERAL for constants defined in the class. Your example LED library doesn't use any unique literals* 
whereas the built-in Arduino functions like pifiModeQ, for example, use INRUT ami OUTPUT as literals. 


Alternate Cores 

Since Arduino release 0*010, It has been possible to add support for alternate cores in the Arduino 
software. This allows developers to use microcontroller chips other than theories that have been 
traditionally supported in the Arduino ecosystem: that is, the ATmegaS* its successors, and die 
AT mega-2560. 

Here is an example showing bow to use the Arduino software to write programs for a much smaller 
device, the AT tiny ISA. The ATtiny 1 3A sports I Kb of program memory, &4 bytes of SRAM . a single ft- bit 
timerj'cnu nter with two PWM channels, and a 4- channel analog- to -digital converter lADQ. and runs at 
up to 20Mllz. It's available in an eight-pin package in hnth surface- mount variations and the traditional 
dual-inline package (DIPj, making it breadboard friendly. Another nice tiling about this chip Is that the 
price Is about one dollar, even it) small quantities. 

On the other hand, this little device is, well* little. Quite little. It has a total of eight pins* and two of 
them are V, , and ground* leaving only six. And one of those remaining pins can be either an i i'O pin or 
the RESET pin, and for your purposes It needs to be the RESET pin* so you're left with a grand total of 
five general- purpose I/O lines. 

It's true that the ATtiny l TA is also available in a 10- and 20-pln surface -mount package, but those 
additional pins aren't connected to anything. You don't get the bonus extra ADC Inputs as you do with 
the surface-mount version of the ATmega32G. Still, let’s see what you can do with five I/O lines. 

To convince the Arduino software that you really want to work with a new kind of Arduino hoard, 
you need to create at least three new hies and some new subdirectories. 

First you must identify your Arduino sketches folder on your PC. Select File > Preferences, and look 
at the first item in the resulting dialog box. Ii should he Sketchbook Location. 

In this folder, you must create a new folder called hardware, if It doesn't already exist. This Is where 
the Arduino software looks for information about additional boards, bootloaders* cores* and 
programmers. In this basic example, you add only one new board and one new core for that board. You 
see the bootloader and programmer options shortly. 
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A New Arduino Board: tinyCylon 

In this (possibly) new hardware folder, you need to creates file called boaids.txt that contains a brief 
description of your new board. You’re going to build a board that has an ATtlnylSA processor and five 
LCDs that scan back and forth, called the tittyCylort. The Arduino software has Its own boards „ txt file in 
another location that describes all the hoards you see In the Tools > Board menu. Your boards, txt file 
(even though it contains only a s Logic board) should look like Listing il 

Listing iJi-G- boards *txt File for Your New Hoard, r he tinyCylon 
fffcit boards, txt 
ft tinydylan 

tinyCylon . name= tinyCylon 

tinyCylon „ build .acu=attlnyl J 
t i nyCyl on . build . f _cp u= 12 00 000 L 
tinyCylon .build . core^ATtinyi JA 

tinyCylon . upload .«aximuin_size- 1024 
tinyCylon. upload. using=arduino, ArduinoISP 

That's all you need for right now. Each Line lit [bis file describes one piece of information needed to 
compile and upload a sketch for this particular board. The general format is buard, setting-value. 

Lines beginning with it are considered comments and ignored. The first comment line identifies the 
file itself. The next comment identifies the following block of hoard -related definitions. You can have 
more than one board in the boards, txt file, so It helps to be able to clearly see where one definition ends 
and the next one begins. 

You’ll eventually add more definitions to this file, hut for now this is enough. 

The first definition in the file assigns the name linyCyloti to this hoard type. This is the texi the 
Arduino software uses In the board -selection menu. It's a coincidence that this Is the same name used as 
the hoard descriptor In this file. When you expand the file later in this chapter, It should be a little 
cleare r. 

The next line identifies the processor used. Tills Is the parameter passed to both the avr-gct 
compiler as well as avrdude to compile the program and upload it to the chip. The ATtinylS (with no -A 
suffix) has been obsoleted by Atmei and has been replaced with the ATtlnyl3A, which is mostly the same 
hut adds some new power-saving features. The software, however, hasn't quite caught up with the 
hardware in this case: so you tell it that you're using an AT tiny IB Instead of an ATtJnylBA, and it still 
works; fine. The signature bytes or device identifiers in the two chips are Identical. 

The clock speed of the processor is defined on the next line. The ATtinylBA has three bulk- In 
oscillators running at ft.fiMHz, 4.flMilz, and I2E5KJ12. It can also be driven by an external oscillator, but it 
lacks the built-in oscillator circuit needed to use a quartz crystal. 

The default clock option is the internal 9.6 M I Iz oscillator. So why are you using 1.2MHz? Another 
default value in a brand-new 1 , factory- fresh ATtiny I BA Is that the CK.WY8 configuration fuse is 
programmed, dividing the internal oscillator by a factor of eight. This results in the 1,2MHz effective 
clock rate, which is represented as 12000001. The l on the end tells the compiler to treat this number as a 
long integer. It works without the L. but why invite ambiguity? 

Anything having to do whh setting the configuration fuses has to wait until you get the bootloaders 
part of the story, hut there's plenty of fun to be had in the meantime. You'll get there.. Unless, of course, 
you already know how to do all that stuff. In which case, please, go nuts. 


263 


Chapter i i softwajre design 


This clock rate is also made available in any code written, for this board, defined as the compiler 
symbol ^CPh. This symbol was used previously in calculating the baud -rate divisor in Chapter 6. You 
don't have to worry about that for now, because the ATtinylM doesn't have a hardware US ART 
peripheral. 

The core to be used for this hoard is defined In the next line. The ATtinylSA Isn’t covered by the 
current or legacy cores made available by the Ardulno software. That means you get to write them. This 
process is described shortly; stay tuned. 

The next section of the boards . t;<t file describes the upload mechanism needed for your new board. 
This simplistic, Illustrative example doesn't use a bootloader. In tills way, you can devote the entire 
program memory space to your sketch. This is a good thing, because there's just not that much space to 
go around. 

The maximum upload size (in bytes] Is specified In the next line. You set It to 1,024 in this example 
because that’s the maximum amount you can squeeze Into the ATtlnyl3A’s program memory. 

Finally, you must Indicate the proper upload mechanism. Because you aren't using a hoot Loader in 
the traditional Ardulno fashion, you specify the use of the ArdulnoISP In-System Programmer (ISP). The 
Ardulno ISP is lira de out of an Ardulno and some wires. The complete procedure for getting all this 
arranged correctly is detailed shortly. You have a few more files to generate before you can upload 
anything. 


Defining a New Arduino Core 

Create another subfolder in your hardnare/tinyCylon folder, and name it cares. In the new cores 
subdirectory, create yet another subfolder called ATtlnyl3A. This is the location of the core files needed 
by the Arduino software to properly compile your sketches for boards utilizing this core. 

At a minimum, you need only two files In this folder: main. epp and Arduino, h. The Arduino software 
uscsrsain.tpp to wrap up the canonical Arduino setup Q and Loop[ J functions. You place calls to these 
functions in a more traditional main( ) function after Including your very own Arduino, h file, which you 
also get to write. 

The main, epp file contains your main () function, which Is where allC programs appear to begin 
execution, In reality, the compiler automatically Inserts a Little housekeeping and Initialization code, 
because you're adding yet a not her layer to this structure, you'll eventually add your own initialization 
code to the main . epp file, but you skip that right now in the Interest of simplifying this exam pie. You 
complicate it enough later. 

A working main, epp file Is shown in Listing 11-7. 

Listing i 1 "7. Bare Minimum main. epp File Needed to Implement a New Arduino Core 

SincLude ’Arduino. h" 

int main(void) { 
setupO; 
while(l) { 
loopO; 

1 

return 0 ; // this never happens 

} 


Your main, epp program file begins with a compiler directive to include the contents of your 
Arduino. h file, which you shall compose anon. Note that the header file name is enclosed In double 
quotes and notangle h rackets. This tells the compiler to use the file hy drat name in the current 
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Attbd trectory Instead of the system -wide include path specification. You want to use yourArduino.fo and 
not the Arduino version. 

Following ibe header file, you have a very simple itiainf} function that calls the setupQ function 
once and then calls the loupO function repeatedly from within an endless hhlle{) loop. 

To prevent compiler warning messages, you add a completely gratuitous return 0; statement. Your 
forebears thought that the main ( ) function should be Invoked by an operating system of some sort and 
that it might be useful to find out under what circumstances ibei»ain() function returned. Therefore, the 
typical main( ) function Is always expected to return a signed integer value upon return. Liven today, 
compilers insist on honoring this convention unless you specifically tell them u i lie i wise. With the avr- 
gcc compiler, this can be done by adding the -ffreestanding compiler option to the command Line. This 
isn't, however, an easy thing to do in the Arduino environment at this time. 

You’ll eventually add your own init{) function to the sain, epp file and Include a call to it in the 
eainO function just before the call to the user- supplied setupQ function. That can xvait fora bit and Is 
im pic me n ted sh o rtly. 

You have one more file to creates Arduinu . h. The good news is that not much Is needed in this hie at 
the moment. Listing 1 1 -fl shows how little you need to get started with an example application. 

Lh litis i J Sore Minimum Arduino. h Filr Needed to Implement a New Arduino Core 

Sifndef Arduino_h 
fidefine Arduino_h 

ffinclude <avr/io.h> 

void setup{vc>id); 
void loop (void); 

fiend if 

The Include guard mechanism, which you may remember from the previous section on writing 
Arduino lihrarles, begins your short include file. The only other additions you need to make are an 
ff include directive of your own and function prototypes for your user-supplied setup () and loop() 
functions. 

You really do need to Include a lot more here, If you want anything resembling expected Arduino 
functionality in your sketches. You start with the bare minimum, which Is to include the header file 
<avr/io.h> from the avi-libc library that defines the names of the internal registers and bits you need 
for your sample sketch. 

The function prototypes are needed to tell the compiler what to expect from the user-supplied 
setupQ and loop() functions. The number and type of parameters as well as the return type have to be 
known to the compiler to property stitch everything together. This Is necessary only because you're 
referring ta those two function in your main () function, without having defined them previously, (fall 
these functions were In the same source flic, and the function definitions preceded the references to 
them, the prototypes wouldn't be required. 

The compiler otherwise assumes, In the absence of function prototypes, that all functions take no 
parameters and return a signed integer value. Because that is wot the ease with your user-supplied 
setup() and loopO functions, you must spell out how they're to l>e used. 

That’s all you need in your Arduino, h file — at a minimum. You add more to it shortly. 
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Note Rem ember to compl etely exit and restart the Ard u ino software for these changes to tafte effect. 


Writing the tlnyGyion Sketch 

Let's write a short sketch to demonstrate what yo j can do with this new core Remem her that your hoard 
is called a tinyCylon arid has five LEDs that are ilium inaied In a back-and-forth scanning motion. This Is 
often called a Larson Scanner* Ln tribute to Glen Larson,, who developed both the Battlesmr Cndactica and 
Knight Rider TV shows. These shows feature the iconic scanner effect. 

Your LED scanner is a hit more humble. If you wire an LED and a \2tiil resistor to each of the 
available 3(0 pins and arrange the LEDs in a straight line, you cat] achieve the basic scanner effect using 
the sketch in Listing 11-9. 

Listing 11-9. Larson Scanner Sketch Using the New ATtinyliA Core 

void setupO { 

DDftS = ObQOQlllii; 

} 

void delay (volatile unsigned long int I) { 
while(i)' i--; 

} 

void loopO { 

for (PART 13 - l; PORTfe < 32; PORTB«=i) { 
delay (aooooo); 

> 

for (PORT 13 = a; P0RT6 > 1; PQftT&>>=l) { 
delay (lOOQQG) ; 

> 

} 


You start out in the typical Ard ui no fashion with a setup( ) function. This function performs only a 
single initialization step, and Lhat Ls in configure the lower five pins of the Port lit data direction register 
(DDRBt to he outputs. Remember that a one makes an output and a zero makes an input, and all the pins 
are Inputs at startup. 

You don't use the pinMode( ) function because it doesn't exist yet In your core implementation. Also, 
your core wouldn’t know what an OUlPli ! or an iNPhf was, anyway. You haven't defined those in your 
Ardulne.h file yet. In truth, they're just numbers (OUTPUT is a one. and INPUT is a zero, not coincidentally), 
hut you have to define them using the compiler directive Sdef ine to associate the word with the value. 

You don't need to do that yet. hecause you already know how to manipulate line 1/0 Lines by writing 
to and reading from the hardware registers directly |see Chapters tf> and 7 if you need a reminder]. This 
works in your new sketch because you did Lake the time to include the<avr/io.h> header file, which 
gives names to all the registers and iheir constituent hLis. 

Next in your tLnyCylon sketeh you find adclayQ function defined. Why? You know why. Because 
you didn’t already define one within your skeletal core definition. At this point, your sketeh has access to 
all tire functionality of the C and C++ programming languages, as well as an In-depth knowledge of and 
access to the inner workings of the AVR hardware. That's a lot. Yet it has wane of the Ardulno-specLfic 
capabilities of even the most humble Arduino sketch (that Is, a sketeh written for one of the supported 
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cores). These Include all the bit-manipulation functions like digitaLKead{ ) and digitalWritcO, the 
analog Input and PWM uutpui functions analogfcead Q and analog'Nrite(), and the delay functions like 
deLayO. delayMicroseeondsQ, and millisQ. 

The delay () function you supply here counts down from a number that the caller supplies* and then 
returns. The numher is declared as a volatile unsigned long int primarily so that the compiler doesn't 
make assumptions about the usage (or non-usage] of this parameter arid optimize your function out of 
existence. Secondarily, it needs to he a Earge number (unsigned Long Integers are 32-bLt numbers 
according to the avr-gtt compiler) because even at a leisurely L ,2MHz clock rate, this chip is still 
screaming fast, and smaller numbers would produce really short delays that result in LEDs flashing too 
fast to see. 

The loopQ function performs a single hack-and- forth sweep of the LCDs by shifting a 1 from the 
lowest bit in the PORTB hardware register to the fifth position and then shifting it backdown again. This 
is accomplished using two forO loops, one to shift up and the other to shift down. A call to your own 
delay 0 function is included in each of the for() loops to maintain the right speed. 


Bringing It Ail Together 

You have everything you need to compile a sketch for your newly defined core, along with a pretty good 
idea of what it will and won't do for you at this point. 

Be sure to select the tinyCylon option in the Tools ► Board menu. Otherwise, the Arduino software 
will compile your new tlnyCylon sketch for whatever board you were working with most recently. A good 
indication that this is the problem is If you get error messages complaining about “multiple definitions 
of ‘delay.'” Choose the correct board, compile the sketch, aod see what happens. Cross your Fingers! 

You should he greeted with a status line that says "Done compiling." The text area below the status 
line should indicate "Binary sketch size' J74 bytes (of a 1024 byte maximum)," if all goes well. 

That message tells you three Important things. First, It works. Yip! Second, sketches written for your 
new core are tiny! One hundred and seventy Four bytes is about a third oF the smallest sketches you were 
able to shrink in Chapter &. The third thing is that the compiler Is definitely using your new core files, as 
revealed by the “102.4 byte maximum" part of the message. 

Now all you have to do is get those ones and zeros into an ATtlnyl3A! 


Uploading a Sketch Without a Bootloader 

As mentioned previously, you aren’t implementing a bootloader In your new core. Why not? It's entirely 
possible, because the ATtinyiSA has the ability to rewrite its own program memory. However, to do ibis, 
iL would have to emulate the programming protocol supported by the STK500 development system. This 
is what the bootloaders In the existing Arduino boards have emulated. The new Optiboot shipping in the 
current Arduino Unoand Arduino Mega 2560 Is considered tiny hy bootloader standards but would 
occupy half the available program space of the miniscule ATtinylSA {not including the extra software 
needed to emulate the missing US ART peripheral). You leave the enticing prospect oF an ATtiny ISA- 
based hoot loader as a Project for Future Reference. 

Don't despair! No bootloader doesn't mean no uploading of sketches. You can still get there, but 
you need some help, In the form of a device programmer, or ISP. Luckily for you, as mentioned earlier, 
there's an example sketch For that: Arduino iSP. This Ardulno-supplled example sketch turns your 
Arduino into an ISP. Well, almost. You need to make one small (hut nonpermanent) addition to the 
Arduino lino to make this sketch work properly. 

First, load the Arduino ISP sketch In the code editor, compile it, and upload Li in the normal Fashion 
to your Arduino Uno or equivalent. This procedure works quite well with breadboard Arduinos as well. 
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After successfully programming the ArduinoISP sketch Into your Arduino of choice, remove the USD 
or power cable from Lt. Now install a ID^F capacitor across the RESET line and the GND connection 
brought out to the power expansion connector, or wherever they happen to be on your particular 
Ardulnn. IF your capacitor is polarized, be sure to put the negative striped lead in the GND connection 
and site positive lead 1st the RESET connection. 

This capacitor effectively filters, out the incoming reset pulses that come from your PC when the 
Arduino software starts to program your part. Because you want to program a part further downstream, 
you filter the reset pulses coming into the Arduino. Otherwise, you'd Invoke the Arduino 's bootloader 
and program that Arduino, and that's not what you want at all. 

You also need to make six more connections between your Arduino-as- ISP and tire target device, the 
ATtlnylBA chip. They're summarized in Table 1 l-l. 


fab it 1 1 -1 . Conneiliani Needed to Use the Arduino as an ISP for tin A TtinyI3A 


Signal Narine 

Arduino Pin 

ATtirvy 13A Pin 

RESET 

m 

1 

MO SI 

li 

s 

Ml SO 

12 

6 

SCK 

12 

7 

V,. 

+ Er 

S 

GND 

GND 

4 


This technique, in theory, will work on any Atm el AVR that supports in -system programming. You 
need to check with the datasheet to find out which pins are used for ISP-mode programming on 
different devices. 

Figure 11-1 shows this wiring arrangement on a solderless breadboard. The green LED on the 
bottom half of the breadboard Isa power-on Indicator. The red LED on the top half shows programming 
activity, and the green LED on top fades up and down in brightness to Indicate a heartbeat, meaning 
yn u r Ar dul no -as- IS P Is st 111 al ive. 
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figure 11-1. A breadboard Arduino being used as an iSP with an ATtinylSA connected as a itnyCyfon LED 
scanner. Note the extra SOftF capacitor installed on the RESET line (lower left). 

Recall that in [he boards . txt Hie you created for your new tinyCylon board, an the very Last line, you 
designated the upload process to be performed using the ArdulnoISP. Other programmers are also 
available, and you’re encouraged to try them and see what works and what doesn't. The assumption in 
this book has been that you have forbade access to) and Arduino II no or equivalent If you have 
additional hardware, that’s great. tooJ If not, you don't have to fee] left nut, nor must you ittt mediately go 
out and spend a Lot more money. 

However, because you've already set everything up to use the Arduino ISP automatically, you can 
now click the Upload button, and your tlnyCylon sketch should be programmed Into the ATttnyi3A 
chip. Alternately, you can choose File > Upload Using Programmer, as long as you select the correct 
programmer from Tools >- Programmer. 

The Arduino software, ever vigilant, recompiles your sketch and proceeds to the uploading part. 
Lights flash, time passes, and then you should he rewarded with a mesmerizing l.LD scanner. 

You’ll probably get a warning message from avrdude to this effect: "avrdude: please define PAGEL 
and M2 signals in the configuration file for part ATtlnyi3. , ’ You can safely Ignore this warning. 


Setting the Configuration Fuses 

There are several ways that you can program tire fuses on your new ATtlnyl3A chip, should you want to. 
Most of them, however, require you to read and decipher the relevant bit combinations from [he data 
sheet and then use a vr dude to actually do the fuse programming. 

Although these configuration fuses are nonvolatile (that Is, they retain their settings even after 
power has been removed), they aren’t fuses in the sense that they cat] only be blown once and then 
never again altered. They can be set and reset many times. The problem with fuses arises from the fact 
that several possible combinations of fuse settings will render your AVR chip completely inaccessible. 

The best possible way to program the configuration fuses is from within a program that offers smart 
fuse warnings: that Is, the program alerts you to possibly irrevocable fuse combinations before 
programming them for you. AVR Studio and the AVR Plugin for Eclipse both offer ibis safety feature and 
are described in detail later in this chapter. 
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Fuse Settings the Hard Way 

You can manually set the fuses using the avrdude utility from the command tine. This is as tedious and 
error- pro tie as It sounds. However, if you have the Arduino software, you already have the avrdude 
software installed. Whether or not you can get to it is another matter. 

The short version of the story is that you must have your operating system's path variable set to 
point to the subdirectory or folder where the avrdude utility has been installed. The Arduino software 
gets around this requirement by specifying a fully qualified pathname prefixing the avrdude command 
every time it's used. 

Open a command-line window, and try typing avrdude and pressing Enter to see what hap pens. 
When invoked with no comm and- line options like this, avrdude patiently lists all of its possible options, 
without actually doing anything. This is a good test to see if avrdude is presently in your system's path. If 
it's not, you either need to add it to the path or copy both the avrdude executable and Its accompanying 
configuration file, avrdude .eon f, Into a subdirectory that is included In your systems' path variable. 

These steps obviously vary from one operating system to another, Assuming you can execute the avrdude 
utility from a command line, let's proceed. 

From the command line, Issue the following command: 

avrdude -p attinylj -c stk500vl -b 192 QQ -P UAcnili ^q -q -D hfusc:r -U lfuse^ r ih 

The avrdude utility and its colorful command -line options are described in Chapter 2, Briefly 
reviewing, -p is the part (device), -c is the programmer protocol, -b is Lhc hand rate (required to work 
properly with the Arduino! SP), -P is the serial port to use (your port is probably different), and -q Is for 
queil or quiet (and, yes, there are two of them, tell high to be doubly quiet). Then comes some gibberish 
that reads out the values of the two eight-bit fuses on the ATtlnyl3A: the high fuse and the low fuse. 

You get the standard complaint from avrdude regarding PAGE Land BS2. Either fix the configuration 
file already, or ignore. It s your choice. 

After tliis warning, and because of the double -hush -hush, you should get just two lines printed out 
on the console: 

Qxff 

Ox6a 


This is assuming you're using a brand-new, factory-fresh ATtisiyiJA chip. 


Note Make a nate of your fuse settings while your circuit still works. 


Brand-new, factory-fresh ATtLnyl3A chips have ihelr high fuses set toOxFF and their low fuses set to 
OvfiA. A confusing Atm el standard is that fuses are considered programmed when their value Is 0 and 
considered unprogrammed when liieir value is 1. This happens to correspond with the typical behavior 
of EPROMS, which were what Atinel was successfully manufacturing before It started making 
microcontrollers. Old habits die hard. 

You can safely change die CK0IV3 configuration fuse from a zero to a one, ilius disabling the default 
system clock prescaler and allowing the chip 10 run full-bore at B.HMMz. TbeCKDIVfi configuration bit Is 
located In bit 4 of the low -fuse byte. This changes the composite value of the low -fuse byte from OxSA to 
Qx7A. It's just hexadecimal snath with a weird industry convention thrown in. 
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To write this new value to your ATtinyiSA chip, issue the following command: 
avrdude -p attinyu -e stkSOOvl -b 19200 -P YYACMH5 -q -q -U lfuse :w ;0:x7A:a 

Most of the command -line parameters are identical. You omit the first of the -ll clauses and modify 
the remaining one. Instead of doing an a for read on the Low -fuse byte, you're now performing a .v for 
write. Instead of the - (dash), which everyone tunics Is a reference to stdout or console (the standard 
output device], you specify the exact value of &x?A, with the [raJEing format slgnlfler changed from h for 
it exacted met l to rn for manual. 

Well, chat s something no one wants to have to do twice. Let's figure out what fuse settings you want 
once and for aLE, write them down, and then let the machine handle Jt front here. 


Fuse Settings the Not-As-Hard Way 

To be able to change the fuse settings from within the Arduino environment, you have to resort, again, to 
trickery. One of the options available is Burn Bootloader, one of the options in the Tools menu. 

The burning of the bootloader 1 a a task that Involves not Just the writing of the bootloader Image flie 
to the chip, but also a slew of other, aneittary operations. First, the avrdude utility is Instructed to erase 
the chip, reset the program memory-lock hits to allow writing, and then write the high and low fuse 
bytes, in that order. If this works, a second avrdude command is issued, this time writing the bootloader 
file and then resetting lock bits. 

So that's tiie mechanism you use to set the fuse bytes, it's a bit of a winding road, but you'll get 
there. 

Bear In mind that each of these individual actions Is composed of a write and an accompanying 
verification step before proceeding to the next Item in the list. That may explain why it takes 
approximately ten seconds or longer to write a new bootloader. 

The details of the bootloader-burning process are specified in theboards.txt file. You need to add a 
few lines to your new boards, txt file to convince the Arduino software to update the bootloader for you. 
See Listing 11- 10. 

Listing ii^io. Additional Lines to Add to boa ids . txt 

t i nytyl on . bootl oa de r „ Low_f u ses= Ox 7 A 
tinytylon . bootloader ,blgh_fu ses= Ox FF 
t i nyCyl on . bootl oa dc r . uni oc k_ b its =Q x } F 
t i ny tylon . bootl oa de r , Loc k_ b i ts-Qx3 F 
tinytylon . bootloader , pat h=ATfinyl3 A 
tinytylon . bootloader 11 o=zero-longth .hex 

The first two lines a re realty the only ones you care about, because they're concerned with the 
values you want to use as the low and high fuse bytes, respectively. In a more perfect world, you'd be 
finished. But you’re a pioneer, blazing trails, and so on. You specify the Lock bits and the unlock bits to 
he the same, which happens to he the setting for no memory protection. You would normally want 
memory protection if you were actually writing a bootloader here, but you’re not, so you don't. 

Fun fact: the datasheet for the ATtlnyiTA says that the default value for the lock bits Is QxFF. It's not. 
h’s Qx3F. The top two bits, for some reason, aren't ones. If vnu specify lock bitsofOxFF, avrdude tries 
mightily to program them for you. As becomes its faithful nature, it also then valiantly attempts to verify 
that said write took place, effectively by reading back the programmed value and comparing it to the 
value that was intended to be written. Because the chip reads back tlxTF, It thinks It failed, and it cancels 
the remaining bootloader-update process with a blast of lengthy error messages. In there, somewhere, is 
the "verify failed" message. 
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Next you come the most deceitful part of your plan: the fake bootloader file. The Ardulno software 
insists that there be a file, and that Li be written,, aitd that it he verified. So you give it one. You specify the 
path to be ATtlnylTA and the file name to be zero-length. hex. This new file needs to he in a 
subdirectory called ATtinyllA |the path) Inside a subdirectory called bootloaders in your new board's 
folder, which In this example istinyCylon. 

[fsa file, ttue enough. It's properly encoded In the correct format, specifically the Intel HEX format, 
it contains a description of a binary Image that is exactly zero bytes long. 

This isn't a problem for either avrdude or the Ardulno software. The file gets written, It gets read 
hack out again, the two are compared (somehow?!, and the results are a success. The process continues. 

You need the file to make this particular trick work, it's a plain -text file, hut all those zeros need to 
be exactly as you see them In Listing 11-11. 

Liitli tt& 11-11. Fake Bootloader File zero- length .hex in Intel HEX Format 

=0000000000 
: 00000001 FF 

In reality, you can put anything you want in that file. The chip wiil be erased in any case. 

This technique pays off when you crafL several different hoards in yourboards.txt file, each with the 
same core but with different bootloader options specified. Then you can change Lhc configuration fuses 
on the fly by selecting a different hoard from the menu and then instructing the Ardulno software to 
Burn Bootloader. 


Note 0b sure to seJect Arduino as !SP from the Tools >- Programmers menu before burning the bootloader. 


Here is what your resulting file hierarchy looks like when you’re finished: 

<Ardui.no sketch bo Qk Locations 
< hardware> 

<tinytylon> 

<bootloaders> 

<ATtlnyl3A> 

zero- Length . hex 

<cares> 

<ATtioyl3A> 

Ardulno, h 
main.cpp 

boards.txt 

ctinyCylons 

tinyCylon . ino 


Expanding the Core 

You have just enough functionality in your baby core to flash some LCDs, and not much else. Any of the 
Arduino -specific features you would like to have available must he added by you. 

A good place to start looking for Inspiration (that is. stuff worth stealing! Is the Arduino, h header file 
supplied by the ArduLno software. Don't try dropping the whole thing in your core folder, ft won't work. 
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The official Arduino. h file relies ana lot of other files being in place for it to compile property. However, 
there tsa lot you can borrow that costs nothing in terms of code space but offers a stigh tly more Ardulno- 
esque user experience. 

For example, if you copy the official Arduino. h file Into your core folder and then remove tf/f the fl te- 
Include directives, along with all the mega-speclflc doodlings, you can use a lot of the built-in macro 
functions, predefined constant values, and function prototypes as a checklist of coding you need to do in 
complete this core. 

Starting a new core is a straightforward process. Finishing one is a challenge. 


And Without Arduino 

The Arduino folk are quick to point out that you cao use any tools you want with your Arduino I/O 
Board. Again, as plainly stated in the official Arduino FAQ, "It's an AVR development hoard." 

Now that you know what an AVR is. let's apply that knowledge toward learning about some other 
methods that have become popular, not Just with Arduino sand the eight-bit AVRs, bui with embedded 
development projects of every kind. 

One of the tremendous advantages of the Arduino-supplled software is its platform Independence. 
Virtually the same software runs on Windows, Linux, or Mac. That's quite ao accomplishment! 
Unfortunately, that can'i necessarily be said for most of the alternative programming environments 
available for the Arduino. The majority of them seem to have a preference for supporting Microsoft's 
popular operating systems. This obstacle can sometimes be overcome with emulators, hui this certainly 
isn't guaranteed in all situations. 


The Bare Metal, Revisited 

3n Chapter 2, you looked at a method for writing a simple program in C to blink an LED. Once the source 
code was written, H was Just a matter of executing three cnmmand-line instructions and mild, the LCD 
h linked. 

As promised In Chapter 2, a better way of invoking the compiler and so on to program the chip can 
he realized using makefiles and the sake utility. The Arduino software for Windows includes a copy of the 
GNU make uiility, contained In the cAurduinu installation di rectory> /hardwa re /tools ! a vr /utils /bin 
folder. You need to adjust your system path variable to be aide to access It from the command Line. Linux 
and Mac OSX have their own native versions of the Hake utility available. 

The make uiility uses a makefile iq specify a set of rules. These rules indicate what should be done, 
and when. The make utility can tell when a file has been modified and can then perform all tlte necessary 
actions to bring the entire project up to date. 

In the simplest scenario, you have a single source file. When the compiler crunches this file, it 
produces an object file. You extract the binary image required for downloading to the chip from this 
object file. This binary linage file, often formatted as an Intel HEX file, is then uploaded to the AVR chip 
using tbeavrdudc utility. 

At each step along this path, your operating system updates hies at your request and places a 
timestamp on them, sometimes known as a time of update. So when you edit a file and then save your 
changes, tire time of update for that file is changed. The make utility uses this information to tell when 
your project needs its internal files updated. If the time of update for your source file is newer than the 
object file, it recompiles the source file for you. If the object file Is then newer than the binary file, and so 
on, this produces a cascade of activity until everything is properly updated. 

The makefile is a specially formatted text file that lists all the rules for this updating process. In make 
parlance, there are targets and there are dependencies. A target Isa file that needs id be built by the 
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compiler or some other utility. The dependencies are the files that govern when a new target needs to be 
built An example ill nitrates this more succinctly. 

To automate the compilation and upload process for your Blink in C project, you begin with the 
source code, blink, c, and a makefile, outlined In Listing 1 1-12. 

Listing 11-12. Makefile for the Simple Blink in C Project 
S makefile for blink 
all; blink .he*, 
blink. hex: blink. o 

avr-objeopy ‘0 ibex blink . o blink. hex 
blink. n: blink. c 

avr-gec -srtitu-atmcgaliSp blink. c -o blink . a 
prog: blink. hex 

avr-dude -p atmega32Sp -c arduino -P VYY.YCGHli -U flash :w; blink. hex; i*- 
-C D: \Progra' v l\arduino-l. D-betal/hardware/tDol&2avr/etc/avEdudc.conf 

c leant 

rs blink . q 

ra blink. hex 

The first line is a comment, as indicated by the leading If. It's always a good idea to use comments 
liberally when you can. 

The next line is a phony target that you name all. All the rules begin with a target. Targets always, 
begin. In the very first column of a new line and arc followed by a colon. Sometimes the target is the 
name of a file, and sometimes it serves another purpose. Because these other targets don’t point to real 
files, they're described as phony. 

Phony targets can be very useful, however. The clean target instructs the make utility to clean up all 
the intermediate and final forms of your code, using the rm (remove) command. This subsequent ly 
forces a complete recompile when the Hake utility is activated again. 

You also use a phony prog target to invoke the avrdude utility to upload your sketch. 

For rules that only need to run when something is out of date, you add the dependency ( o r 
dependencies) on the same line, after the target. If a target lias no dependencies, it always executes 
when called, it can have one or more dependencies, which are usually the files that have changed, thus 
requiring the targets to be updated. 

The next part of tire rule is the action to be performed If the rule is satisfied. The action is written on 
the next line, following the rule, and is always indented using exactly one tab character. Actions are 
comm and -line instructions that are executed when the rule needs to he enforced. 

The default target for theasakc utility is either all or the first rule encountered in the makefile. You 
define a dependency for all in your makefile: the file blink. hex. The make utility looks fora rule for the 
b 1 ink . hex file and finds it (it's the very next rule). The blink, hex file depends on the blink, o file, which, if 
you peek ahead a bit, depends on the blink, c file, which is your original source file. 

The phony target prog also depends on the blink, hex file being up to date. If It Isn't, the whole 
process to make sure blink, hex is current is enacted. 

You start this process by typing mi kk at a comm and -line prompt from within the subdirectory where 
your flies are contained. If you give the make utility no command-line arguments, it assumes the target Is 
all and proceeds. You can also type Mike prug or mi kid tleuft- 
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To produce the object file (blink. e), the compiler is invoked with all the appropriate command -line 
options. To produce the binary image file. the avr-ob} copy utility is used to extract the image and snore it 
in the blink .hex file. You should .start to be able to see bow this is arranged in the structure of the 
makefile. 

This is a simple makefile. The make utility has a lot of additional capabilities you're not us big here. It 
does only a few things for you r hut Lt’s certainly easier to use than typing outaLE the steps to compile and 
upload the sketch by band. 

The main point of the make utility, however, is to intelligently update only the necessary files without 
wasting time on any steps that need not be taken. This becomes tremendously advantageous when your 
project contains many flies spread across multiple folders. 

Note that some weirdness is going on in tbeavjrdudc: command line, hirst, the selected serial port to 
he used (COM! J in this example; yours is probahly different) is preceded by .several backslashes and a 
period, like this: 'iA\ J ACft w .li. This is a Windows-specific requirement for COM ports with more than a 
single -digit number. You have to add an extra slash to the madness to get the make utility to send the 
proper sequence (which ought to be \\.\COMii. with two slashes, a period, and then another slash). 

You can use the -c arduino option if you're using an Ardutno Uno. If you’re using a Duemllanove, 
you need to add the -b S7&00 baudrate option to make it work. 

The make utility uses the backward -slash chaiaeter to escape special characters. You actually juanfa 
literal slash here (several, in fact), so you add a preceding slash to Lhe mix, and it works fine. 

Also note that you must specify the location of the avrdude. conf configuration file on the command 
line, using the -C comm and -line option. The avrdude utility doesn’t understand file names with spaces in 
them. Normally you would enclose the entire path and filename In double quotes, hut the combination 
of make and avrdude doesn't like that, either. You resori to a very old Microsoft workaround, replacing the 
P rogram F I les ( x S 6 ) fo Ider na me wi t h P rogE a * 1 . Tb is wo rkaro und em erged w h en m ost of t h e wo rid 
broke free of the previous ft.3 file-naming convention (eight characters for the file name and three 
characters for the file extension, separated by a period]. 

Also note that some of the slashes In the path to the avrdude. conf file are backslashes and some are 
forward slashes. Fun! This is actually how the Arduino software invokes the avrdude utility from within 
whatever constitutes its automatic build intelligence. 

You can bypass tills configuration file madness by placing a copy of the avrdude. conf file an the 
same directory as the avrdude executable file. Technically, they don't belong in the same place 
(executables and data files arc a had mix), but it makes invoking tbe avrdude command muck simpler for 
you. Or you can use the Atmel AVR toolchain, described in the next section, instead. It keeps the two files 
together. 

Please feel encouraged to not only use simple makefiles for projects like Lhese, but also invest in 
learning a little more about how make and other handy utilities can help you spend less time typing and 
more time writing. 

On the other hand, sometimes a batch file fr easier. 


Other Development Environments 

Nobody says you have to use the Arduino software to program your Arduino. Many alternative 
environments are available, both open source and commercial. 

This section looks at a couple of the most popular alternative development environments (IDEs) 
available for the AVR family. 


275 


Chapter i i software design 


Aimers AVR Studio 

AVR Studio Is the official development environment for AVR devices. It's provided free of charge from 
Atmel, although the source code Is proprietary. See the Atmel website (wwnGatmoL.com) to download the 
Windows-only software. Von need to register, but the registration is free. 

Note that this Is a really big download (>6ClUMB], and it also requires additional large downloads 
from Microsoft. Start these downloads early,, and make sure your laptop Is plugged into the wall. 

It's not really fair in call AVR Studio an alternative rn the Arduino environment. The Ardulno 
concept front the beginning was to hide as much of the complexity of embedded design from the user as 
possible, to help promote faster learning curves and wider adoption among nontechnical users. As such, 
th e A rd u itto so ft w are is real ly the al t erna five b ere . 

The most recent version of AVR Studio is Version 5 h which is based on the Microsoft Visual Studio 
Shell, for those of you familiar with other Microsoft programming environments, litis will look quite 
familiar [see Figure 11-2). 



1 J-jf, A screenshot from Atmei's A VR Studio 5, showing a freshly created project using the Project 

Wizard 

Even though Version S is the latest and greatest, it's still so new that not ail of Atmei’s extensive 
portfolio of devices arc- fully supported, for this and other reasons (mostly because some people resist 
change), the previous version. Version 4, remains popular with hobbyists and professionals alike. Sec 
figure 11-3. 
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11 -Sr A screenshot from Atmel's AVR Studio 4, in development mode 

Again, nothing earth-shattering or unconventional here. If you're familiar with other development 
environments, you begin to see a trend. There arc several panes Lit the enclosing window, each having a 
different function. Along the top you see some Icons in a toolbar. On Lite left is a hierarchical listing of all 
the elements ofthc project, Including the source filets), dependencies, and so on. The main pane Is 
devoted to the code editor, which highlights syntax by color. You can configure the colors and font used 
however you Like. Multiple source code files can he edited at once, and the tabs along the bottom of the 
editor window Let you ftlp hack and forth among them. At the bottom is the build -rc.su Its window, 
showing the results from the East build attempt. 

AVR Studio supports both assembly language programs as well as programs written for the GNU 
Compiler Collection {GCC]. This Just happens to be the same family of compilers used by the Arduino 
software. 

TheGCC programs aren't included with AVR Studio. You must download them and install them 
yourself. For a good, long while, the best Windows port of the AVR port of the GCC (avr-gee) was the 
WinAVR package managed by Erie Weddlngton and available from SourceForge 
(http: //winavr. sourceforge.net). The Arduino Team borrowed heavily from this distribution for the 
Windows version of the Arduino software. 

The combination of WinAVR and AVR Studio still works great and will continue to work for years to 
come. The only problems you 'll run into axe mainly related to support for new devices as they become 
available. 

To get the Latest officially supported version of the avr-gee tonic bain, you can also use the Atm el 
AVR Toolchaln for Windows (also available for Linux). AVR Studio 4 w‘«rks well with this toolchain, as 
well as the WinAVR package. 

The main advantage of using AVR Studio 4 instead of the Arduino environment Is the tight 
integration of device programming and debugging tools. These tools allow you to write, program, and 
debug your program all in the same software framework. 
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Eclipse 

T3u' Eclipse projcel was originally developed within IBM as. a modular, extensible development 
environment. IBM decided in make it an open source project and formed an Industry consortium, The 
Eclipse Foundation eventually emerged as a not-for-prn fit corporation to oversee the future of Eclipse. 

Originally targeted at Java development, Eclipse still sees its greatest strengths in this area. TheC 
Developers Toolkit 1'CDT) is a version of Eclipse specifically designed for C arid C++ programming. See 
Figure 1 1-4. 
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Fi&itr* 1 1 -4. The Eclipse workbench showing the development perspective. Note Ihe AVR icon and menu 
item added via the AVR Eclipse Plugin. 

You can download a version for Windows,. Mac OS X, or Linux front the Eclipse download page at 
. eel ipse. org / d own load s . 

Like the Ardulno software. Eclipse doesn't require an installation, per se. Instead, you download a 
large archive file and unpack it In the location of your choice. In the primary eclipse folder, there should 
he an executable file that you can click to start up Eclipse. 

Eclipse organizes your projects with a UJorirspnc^. This is a designated folder in your computer’s file 
system. Eclipse prompts you for your desired location for this workspace when it first starts, h even 
suggests what It thinks Is a reasonable location for you. 

After this, Eclipse begins to load its workbench. This takes quite a while the first time Eclipse Ls run 
on your machine. Eclipse actually starts up on another screen with Just a handful of Icons. On the right is 
an icon to take you to the workbench; click that Icon to open the development perspective. 

To work effectively with AVR devices, you need to extend the capabilities of Eclipse via a plug-in. 
This Is one of the major design elements of Eclipse, allowing new features to be added Incrementally 
withoLEt having in rebuild the entire system. 


278 


CHAPTER 1 1 SOFTWARE DESIGN 


One Eclipse plug-ln chat works well Is called the AVR Eclipse Plugin, available from http://avr- 
et lipse.SDurce-Forgc.net. However, It's easier to download the plug-in from within Eclipse. In the 
Eclipse workbench, select Help > Install New Software. Tins brings up the Install dialog box. The first 
item in this dialog box Is the Work With text box. Type in the II RL http i //*VE - 
Ecli.pse.saurcefnrga.net/upditesite/'. a ltd click the Add button. This, in turn, brings up the Add 
Repository dialog box, which gives you the opportunity to add a descriptive name to this web address. 
Type anything you want, and cEick OK. 

The Install dialog box momentarily populates [be list in the middle of the screen with a single 
option: CDT Optional Features. Select the check box to the left of this item, and then click Next. Some 
dependency cheeks are made, and you're presented with a list of Items 10 be installed. There should be 
two Items listed: one for i be AVR Eclipse Plugin and another for the sources. Click Next again to proceed 
to the licensing page. 

You must review and accept the licenses presented. The AVR Eclipse Plugin is released under the 
GNU Genera] Public License. If you accept these terms, click the appropriate radio button at the bottom 
of the dialog box, and then click Finish. 

Eclipse begins to download and Install the plugin for you. It warns you that it's unsigned content 
and asks you to verify that you want to continue If you do continue, then when complete, It notifies you 
that Eclipse should be restarted. Allow It to restart: when it does, you have yet another icon on your 
Eclipse workbench toolbar, as well as a new AVR menu. 


Creating a New AVR Project in Eclipse 

From the Eclipse workbench, choose File >■ New > C Project. This brings up theC Project dialog box. 
Type an appropriate project name, and then select Empty Project from the AVR Cross Target Application 
group. Click Next to get tn the Select Configurations dialog box. 

You can click the Advanced settings button to bring tip the project properties, allowing you to 
specify the device type, programmers used, and so forth. You can always return to this area and make 
more changes to the development environment by right-clicking the project name In the Project 
Explorer pane on the left, or by selecting Project ► Properties. 

You need to create a programmer profile. The avrdude utility Is well known to this plug-ln, so It’s 
easy tn configure the necessary options. You no longer have to memorize or look up all tire parameters 
and their possible values. Instead, pick from the available options In the dialog boxes, and youVe all set. 

Once you’ve written your program and successfully compiled It, all it takes Is a click of the AVR icon 
to download (you're downloading now. Instead of uploading in the Arduino world) your program to the 
AVR chip 


Summary 

The Arduino software environment is a great place to start learning about microcontrollers, 
programming, and even hardware. To take it to the next level, you can add your own Arduino libraries 
and create your own Arduino cores for unsupported AVR devices. 

Beyond that is a world of more powerful tools waiting for you. Roth the AVR Studio and the Eclipse 
packages support more than just the elght-blt AVR world, so this could very well be your launching point 
into ... who knows what? The sky is the limit. Newer and more powerful (but cheaper!) microcontrollers 
are being introduced all the time. Keeping up with them ls a full-time Job. 
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Let’s march forward and put this new Information to good use. In the final chapter, you design and 
huild a number of small. Interrelated circuits and devices that come together to be a completely 
autonomous robot. Don't he alarmed. The Crush! Kilt! Destroy! option hasn’t been Implemented. 

And no, that Isn't a personal challenge. 


CHAPTER 12 


Networking 



One Arduino can do a lot. More titan one ArduEno can do more. There’s an old saying: "Many hands 
make light work." Ardulnos are also known for working and playing well with others. The "others" may 
he other Ardulnos, or they can he devices of a different stripe entirely. 

To work together, they have to talk to each other. A certain amount of cooperation is necessary in 
order fora meaningful exchange of information to take place. Who will he involved In this conversation? 
Where will it take place? What are you going to talk about? Who goes first? After these questions are 
answered, the conversation can follow. 

Let’s look at some of the ways you can use both the built-in networking capabilities of the Ardulno 
and some low-cost add-ons that can literacy let your Ardulno talk to the world. 


Point-to-Point Networking 

The Ardulno has several communication interfaces already built in, and Li's trivially easy and relatively 
inexpensive to add communication capabilities these days. First you look at the built- In options, and 
then you reach out a bis and hook up some more Linkages to the outside world. 


Talking Over the Serial Port 

You've already worked extensively with the Ardulno’s built-in serial port. You've given it ho-hum tasks 
like uploading sketches and mindlessly reciting ’ Hello, world!" Wouldn't It he nice If you could 
transcend the mundane shuffle of hits back and forth and have a meaningful conversation? 

The Ardulno s serial port is often hard- wired to the USB interface, making it difficult to apply it to 
other tasks. On the ArduEno Mega 2560, of course, ibis is no problem, because you have three more 
USARTs available for such tasks. All isn't lost with the Ardulno Uno, however, because you can also use 
any pair of digital 1(0 lines to communicate serially using either the Soft Sex ial or New Soft Sc rial library. 

An excellent example of networking you can do with your Arduino right out of the box is to use the 
FLrmata communication protocol to control your Arduino from your PC. Load the Ardulno -supplied 
example sketch by choosing Fife >■ Examples >- Firmata > Standard FLrmata. Compile and upload to 
your Ardulno board. 

Now download the Firmata test software appropriate for your operating system (Linux 32-blt r Mae 
OSX r or Windows) front the Firmata web site: httpt2/f iritiata.org. This test program runs on your PC 
and communicates over the serial port where your Arduino k connected. 

Seteci the correct port, and the software begins to talk back and forth over the serial link. You can 
use the user Interface to control the settings of all the 1(0 pins on your Arduino. Sec Figure 12-1. 
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Figure 12 -]. The Firmatc i rest software. You can configure and control each of the I/O pins on your 
A rd u too from your PC. 

You cun configure any of [he digital pins Lo be Input* Output, PWM, or Servo. The analog input pins 
can likewise he configured as Input* Output, Analog* or PWM. 

When configured as an Input* each pin's state Is reported as either High or Low. Change the setting 
to Output, and you can toggle the purs state using a pushbutton that alternates between High and Low. 

The PWM setting replaces the pushbutton with a slider* allowing you to smoothly adjust the PWM 
value on the pins — assuming they're PWM -capable outputs. If not* they respond Hite any other digital 
output pins when addressed with the ana leghritef) function* having a High level when the PWM value 
is 1213 or larger and a Low value otherwise. 

The Servo configuration also reveals a user-adjustable slider control. Adjusting this control causes a 
servo- compatible control signal to be generated* repeating at 50Hz. The lower limit is S60ps*and the 
upper Iimlils2,4tS0ps. 

All this remote-control tnagie is brought to you by the miracle of an agreed-upon comm and- and 
control-system , implemented over the serial port. 

There's more to the Flrmata protocol than you can see from the simple user Interface example 
program. The latest version also supports communication with shift registers, limited MIDI support, and 
1C peripherals. The protocol Is designed to be easily extendible* so feel free to think up new things for it 
lo talk about. 
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Arduino to Arduino 

Talking to a PC Is almost a no bralner for the Arduino. li r s like U was born to do that kind of thing. What 
else can the Ard Lino's USART talk to? How about another Arduino? 

You can easily make up your own conversation for two Ardulnos. Just deeide wliat needs to he said. 
Break these ideas down into discrete symbols that can be easily emitted by one Arduino and Just as 
easily understood by another Arduino. The implementation details differ, depending on your 
circumstances, hut the basic idea is always the same. 


For example, you can build a doorbell using an Arduino. Yes, it's overkill, hut it's an Imaginary example 
at this point, Isn't it? Once upon a time, a doorbell was a hell attached to a door. Then peogilc started 
stealing the hells. So the bell was mounted on the inside of the door and tied to a string that went 
through a hole in the door. Visitors announcing themselves would tug on the string, thus ringing the bell. 
But why leave something simple and reliable when you can make It more complicated? That was the 
motivation behind the electric doorbell. See Figure 1 2.-2. 


P'igtir* A basic doorbell ctreu it 

When the pushbutton is pressed, it completes a circuit, engaging an electromechanical bell of some 
sort. A transformer is usually used to reduce the working voltage to typically 2 T VAC, One of the nice 
features of this arrangement is that the hell and the button can be separated by quite a longdistance, if 
necessary. This can also he done with a tong hit of string, but Lt starts to get complicated. 

Now replace the pushbutton with an Arduino, and then replace cite doorbell with another Arduino. 
You, umm, also need to attach a pushbutton to the first Arduino, as well as a bell to the second Arduino. 
But let's continue. 


The Doorbell Example 


■=r 



POWER TRANSFORMER 
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This doorbell Arduino illustrated in Figure 12-3 has a momentary- contact pushbutton attached to it. 
and the appropriate sketch is running that can tell for be interrupted] when the doorbell button Is 
pressed. The use of the button is traditional; any appropriate sensor (or combination of sensors) will do. 
This button press initiates the transmission of a "ding dong" message to another Arduino inside your 
house, via the serial port. 


0UTTOH ->T)ing Dnng!‘-> 



Figure 12-S- Using two Ardulnos to build an Irnproued doorbell network 


Note Please note that the TX line of the outside Arduino is connected to the FIX line of the inside Arduino, and 
vice versa. Also, the GKD lines must be connected between the two Ardumos for this to work. 


The Inside Arduino receives the "ding dong" message and decides what to do with It. It) the old days, 
there wasn't a lot of thought put into litis decision. The button was pressed, therefore the belt was struck. 
This behavior was programmed using a length of wire. You don't need two Ardulnos and several wires to 
do what a single loop of wire cao easily do. 

But your inside Arduino has a tiny amount of Intelligence, It can make decisions. A "ding dong" 
message was received; let's decide what to do about that. .Maybe you go ahead and either strike a 
mechanical bell using a solenoid and an appropriate driver circuit, or play a short note or notes on a 
speaker. That's the traditional approach. 

Alternately, you can ring the hell and play a short tune on the speaker and light up a flashing 
indicator light and mute the TV (or pause, depending] and make a note in the doorbell log. 

If the inside Arduino lias some idea of the time of day, perhaps further thought can be put into 
choosing the correct response. Perhaps you don't want 10 he disturbed after bedtime or during naptime, 
or you want a different hell or chime to sound at different times of the day. Lots of options exist when 
your doorbell Is smarter than a length of copper wire. 

Here’s another possible scenario: rite doorbell Arduino (the one outside that has lire pushbutton] 
sends the "ding dong" message Jo response to a button press. The Inside Arduino, with Us fancy brain* 
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decides what to do, and sends a message back to the doorbell Arduino. This message can be a command 
to either say “Who's there?” over a speaker or display the message on an LCD. Maybe it says “Go away.” 
Let your Imagination take over from here, as far as Space Age doorbell systems are concerned. 

The Important concept as that you have two things talking to each other. Yon now know the answers 
to the who, where, and what questions concerning the conversation. Who: two Arduinos. Where: one 
outside with a button, the other Inside with a bell. What: button- press events and possible responses. 


A Two-Node Dimmer Network 

Consider two Arduinos connected as In the doorbell example from the previous section. Each Arduino 
has a diin m able LED attached to PWM output Dt l, as welt as four Individual pushbuttons. The 
respective USARTsare properly cross connected: that Is, the TX of one goes to the RX. of the other, and so 
on. They share a common ground. See Figure 12-4. 



Figure 12-4. A two- node Arduino network, built on a soiderless breadboard. Chip labels wiilt the Arduino 
pin numbers assist in rapid prototyping. Each Arduino has its own reset button along with [our 
programmable pushbuttons. The red LEDs are the dim rouble LEDs mentioned in the example sketch. 
Pressing the buttons on either unit controls the brightness of both LEDs. Not shown is the removable UAB- 
to- TTL adapter used to upload the sketches to the individual Arduinos. 

You want to use the four pushbuttons to control the brightness of the LED. You assign the functions 
On. Off, Bright, and Dim to these buttons. Press the On button, and the LED comes on at full intensity. 
You can Imagine the rest. See Listing 12-1. 
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Listing t£-L Sketch for a Two-Node LED Dimmer Network 

void setup() { 

// pin. directions 

pinHode(ii, CUT PUT) ; U LED on- PHM pin Dll 
pinNode(5j, INPUT); n Ds = button 1 (up) 

pinnode(bj, INPUT); // Db = button 2 (bright) 

pinMode(7, INPUT); // D? = button 3. (dim) 

pinMode[8, INPUT); // DS = button 4 (off) 

// initial settings 
analogWritefllj 0); fi LED off 

digitallfrite(5j HIGH); // enable pullup 

digitalhrite(6, HIGH); // enable pullup 

digitalwrlte(7j HIGH); // enable pullup 

digitalwritefft, HIGH); // enable pullup 

// serial port 
Serial. begin (&fiO€); 

Serial. write(byte(o)); N turn off all the other LEDs 

} 

void loopQ { 

static int brightness = 0; ft the brightness of the LED: D=off J 2SS=on 
static int previous_brightness = 0; if the previous brightness 

previous_brlghtness - brightness; // remember for later 

// check buttons 

if(digitalKead(5) « LOW) brightness - 2SS> if full on 
if(digitalftead(b) ==• -LCn) brightness++; // brighter 
if(digitalftead[7) -= LOW) brightness--; if dimmer 
if (digitalftead(S) ==■ LOW) brightness - 0; // off 

if (brightness < 0) brightness ■= 0; if lower limit 
if (brightness > 2&&) brightness = 2SS; U upper limit 

If (brightness != previous_brightness) { 
it the brightness has changed 

Serial. write(brightness); // broadcast the new brightness 

> 

// any news fro® the network? 
if(Serial.available()) { 

brightness = Serial. read{ ) ; // fetch new brightness level 

> 


1 


analoghritetll, brightness); ii update LED 
delay (10); ii a short delay 
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The setup ( ) function configures the PVVM output Dll as an output and uses the analagHrite£ } 
fu notion to turn off the LED. Technically, you could omit this particular ptnModeO function call, because 
this happens automatically when using theanalogWriteO function. 

The Input pins attached to the pushbuttons arc configured as inputs, and tlieir associated pultup 
resistors are enabled using the digital Hr ite() function. This is necessary because the momentary- 
con tact switches used are connected to ground, but only when they're pressed. When not pressed, the 
input ptns are floating, and there's no telling what they might report. Enabling the built-in pultup 
resistors solves this problem without having to add more hardware. Again, the pin -direction statements 
can be omitted because INPUT is the default state after the chip is reset. The calls to digitalHriteO to 
enable the pultup resistors, however, are required, unless you install actual resistors between the input 
tines and V i:i: . 

The setups ) function finishes by initializing the serial port to run at 9,&fU! baud and sending out a 
binary 0. The reason for this initial transmission Is explained shortly. The parameter passed in the 
Serial. write Q function has to be qualified using ihe byteQ typecast . The Serial. writeQ function is so 
sman that it cant figure out what to do if you tell It to send a zero value, like this: Serial, write(o);. The 
compiler reports “call of overloaded 'wrlte(int3' is ambiguous,” No, you re ambiguous. 

An overloaded lime Linn Is one that has been defined in more than one way, depending on the 
number and type of parameters passed to It. This is very useful for handling different scenarios with a 
generic function that knows how to deal with at! sorts of different combinations of data. Serial. writeQ 
is a good example. However, in this Instance, you have io give the compiler a clue as to what kind of a 
zero you want it to send. Because you want to send a little eight-hit zero for now, you cam ibe constant 
value into a particular data type by surrounding it with the word byie and some parentheses, like this: 
Serial . write(byte (Q) ) ;. 

That's all there is for the setups } function. Now let's move- on to the LoopO function. 

The loopO function starts out with a couple of static Int declarations for brightness and 
previous_brightncss. You use brightness to represent Lhe variable level of brightness you want to emit 
with your big LED on each node. This technically only needs to bean eight-bit value, because that Is the 
default resolution of the PWM functions you're using In ibis sketch. However, by declaring it as a signed, 
integer value lan intj, you can do some tricks with li that make coding the sketch a little more 
straightforward. 

These two variables wouldn't have to be declared as static if you declared them outside the scope 
of the luup{) fnneiion, thereby making them glottal variables. For now, however, they're only used 
within the loop() function, so technically speaking they're local to tEie Loopt) function and there they 
stay. 

At the beginning of the loop() function, you note the present value of the brightness variable by 
assigning Li to the previous_b right ness variable. If the value of the brightness variable changes by lite 
end nf the function, you ean tell hy performing a comparison between these two variables. This lets you 
know if anything needs to happen. In this example, If nothing changes, then nothing needs to be done 
about that. 

Next, you check the state ofeaeb of the pushbuttons. Because the pushbuttons are normally open, 
they aren't connected to ground If they aren't being pressed at the time you check them. Also, because of 
the pullup resistors you enabled on each of the pushbutton inputs, the logic level on each pin Is High if 
the button isn't pressed. Conversely, if the button If pressed, the logic level of the input pin is Low; you 
can read this using the digitaLftead £) function. 

Each button is evaluated in turn. If the button Is currently being pressed, a but ton -specific action Is 
taken with regard to the brightness variable, if the On button is being pressed, the brightness level Is set 
to the maximum: 255. If the Off button is being pressed, the brightness level is set to the minimum: A. 
Alternately, if the Bright button is being pressed, the brightness level is Increased by incrementing the 
value of the brightness variable. The Dim button, when pressed, causes the brightness level to be 
decreased by decrementing the value of tbe brightness variable. 
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If the LED was. already off | the brightness variable was zero] and the Dim hut ton was pressed, what 
would happen? The brightness variable would he decremented, resulting in a negative brightness level. 
Oops. 

Similarly, if the LED was already 00 foil- tilt and the Bright button was pressed, what would happen? 
You guessed it: the value of the brightness variable would he 256, which is no longer within the valid 
range of PW.M duty-cycle settings. 

These specific conditions are tested, and the value of the variable is limited to the proper values. 
This is why you declare the brightness variable to he of type int (a signed, integer number). It’s OK if it 
goes negative or exceeds the eLght-bh range of the PWM hardware. You can fix Lt in software before 
proceeding. 

An alternate approach to value clipping or constraint is to make the appropriate test before the 
adjustment of the value. For example, you could have written the code for handing the Bright and Dim 
buttons as follows: 

i-f((dlgitaLfcead(fi) « LOW) (brightness < IBS)) brightness*-!-; // brighter 

if((dlgltalkead( 7 ) == LOW) (brightness > 0)) brightness--; // dis*er 

Either way, a comparison is performed. In this overly simplistic example, either one works as well as 
the other. In real-life applications, it’s always more complicated. You need to use your good judgment to 
decide which is a more appropriate approach. Try to Lean toward cleaner code with fewer exceptions 
and boundary conditions, if possible. 

[f this wasn't a networking example sketch, you'd he done already. Set the PWM duty cycle using the 
anaLogWrite( ) function, and repeat from the beginning. Done and done. 

However, this is a networking example sketch, so you have to do some networking. First, you need 
to define and describe your network. Right now it's two Arduinos with their U S ARTs cross-connected, if 
one Arduino detects a change in the desired brightness level,, it reports this new setting to the other 
Arduino. it makes litis report by sending the new brightness level as a single byte of information over the 
serial port. TEiere's no handshaking, no error -checking, and no verification. 

Your sketch now has the responsibility to report changes in the desired lighting level to the other 
node. If the brightness level has been altered by the local user (that is, the presser of buttons), you can 
detect that using a couple of different methods. One popular method is to set a flag whenever a button 
itas been pressed and then cheek to see if that flag has been set by the end of the function. Remember to 
reset any such Hags after they have been processed; this requires a separate flag variable lo be declared. 

Your example sketch Is so simple that you can use the value of the brightness variable as your flag 
by comparing Jt with its previous value, cleverly hidden in a variable named piev leu s_b rightness. If the 
variables have the same value, then nothing happened. You can assume [in this example only) this 
means that no buttons were pressed. It the two variables have diverged In value, then something 
happened to cause this. A good assumption is a button press or other event. If it's determined that a 
change did occur, it's reported by sending the new value out the serial port to the other Arduino. 

The sketch also has to respond to changes In lighting-level brightness as reported by the other node. 
You can check this by looking to see if anything has been received via the serial port. The 
Serial, avaiLable[ ) function returns the number of bytes that have been received by the II SARI and 
stored in a buffer. The only two values in which you have interest are someand none. You really don’t 
care about the exact number of bytes received in this example, This allows you to use C s built-in 
trtie/false evaluation mechanism to determine if anything needs to be done. False evaluates to a value of 
zero, and true is anything else (any nonzero value). Therefore, if even a single byte is waiting in the 
Be rial library's buffer (remember, the AVR’s US ART has only a single byte -receive buffer; any other 
buffers tig is done In software), then the Serial. availabLe{) function is evaluated as true (nonzero) in a 
conditional statement, such as used in the example sketch. If there are no bytes waiting in the buffer, 
BeriaL avaiLablef ) Is evaluated as a false statement. This makes for shorter and clearer coding. 


CHAPTER 1 2 NETWORKING 


If a byte has been received via the serial port, it's read and interpreted as the new brightness level. 
Again, no testing or verification is done in ihls trivial example. In real-world applications, you would 
always check in make sure that incoming settings or commands make sense or are valid within the 
context used. 

Now comes the long-awaited explanation of the zero sent on startup. Other than button presses, 
one other event can cause the two LtDs in lose synchronization: this happens when one or the other 
Arduinn loses power or Is otherwise reset. 

In a more well-mannered network, provision is made for a network-status request of some sort that 
allows newly arrived nodes to Inquire. "What's going on?" and respond accordingly. Your network 
message space is completely full, due to the adoption of an overly simplistic network protocol Lhat 
encompasses a one-byre status message. Think about the Implications of this decision for a moment. 

Node synchronization Is maintained by forced updates after any status change. The practical 
upshot of this Ls that if an Arduino gets unplugged or reset, everyone is plunged into Inky darkness — at 
least, until someone can get to one of the pushbuttons and turn lire lights back on. An alternative Is to 
omit the reset scenario and allow a node 10 remain out of synchronization (gasp!) until either another 
(ahem, the other) node updates li or it’s adjusted locally. You get to decide these things when you Invent 
networks. 


Expanding the Network 

Connecting two Ardulnos is certainly fun, and there may even he some useful applications for this new 
technology. Can this little network be expanded? Iioxv would that work? 

Let’s add two more Arduinos to the mix, for a total of four. They can no longer simply he cross- 
connected without adding more circuitry to prevent the respective transmitters from stepping on each 
other. Let’s link them up In a loop, with the TX of the first one going to the RX of the second, then the TX 
of the second one going to the RXof the third, and so on. Finally, the TX of the last Arduino goes back to 
the RX of the first Arduino, completing the loop. See Figure 12-5. 



Figure 1 12-5- A more ambitious four- node network of breadhaarded Arduinos. The USARTs are [need 
together in a loop this rime* forming a circle. The pushbuttons on the third and fourth Arduinos have been 
omitted* but they still have the dtmmable LED that responds to network, updates front the other two 
Arduinos. 
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You only have to make subtle changes in the sketch. The setupQ function remains Intact. The hulk 
of the 1 Li 0 p { ) function remains ana tiered. You only need to address die two network sections of the 
code: the duty -to-report -changes section and the duty- to- con form section. Let's start with the second 
one and then come hack to the first. 

The only change Ln the duty- to- conform section is to echo the incoming status message hack out 
the serial port, thus sending It further along the loop. You have to again outwit the clever SeriaL.Miite[) 
function by camouflaging the brightness variable as a byte with a typecast. Otherwise, it would correctly 
deduce that the brightness variable Isa signed integer lit really Is) that Is 1(5 hits In length and send it as 
2 consecutive bytes, which is n ot what you want. The updated section should look tike this: 

// any other news from the network? 
if (Serial. available*)) { 

brightness - Serial, read(); i i fetch new brightness level 
Serial. wrltefbyte( brightness)); // send It along 

} 


So every time you receive a byte, you send iL hack out? Won’t that cause a cascade effect when the 
status word gets all the way around the loop [which could theoretically he as quickly as 4 milliseconds, if 
the Serial Library were a little more optimized)? Yes, it most certainly would, if you didn't handle that 
very possibility within the duty- to -report-changes section. 

This section works exactly the same way as before, detecting changes by comparing the present 
brightness level with what it was previously. If detected, the same report is made to the network by 
transmitting the new brightness level as a single byte. 

The only addition you need to make to tins code is to wait for the status message to make its way 
around the loop and then eat It up when it arrives. Problem solved, unless two nodes try to send 
different update messages simultaneously. The updated code looks like this: 

if (brightness 3= previous_b right ness) { 

// the brightness has changed 

Serial. write (brightness); /./ broadcast the new brightness 
while (Serial. availablef) == 0 ); if wait for it to come back around 
Serial. read(); // gobble it up; do not re-transmlt 

} 


The only problem with this network methodology (technically, a ring network] is that it's Intolerant 
of any node faults. If even a single Arduino goes offline or loses power, the circle Is broken. To overcome 
this limitation, you should Implement a different network topology (arrangement). 


Other Network Topologies 

A star network* such as the popular Universal Serial Bus (USB), connects all endpoints to a central hub. 
The functions of the hub and of the nodes are very different and require different hardware and 
software. 

A bus network connects all the nodes together with a single medium. Nodes then have to take turns 
talking or risk collisions on the network. Advanced protocols have been developed to Iran die these 
po tentia L t ral n w recks . 

A fully connected net work has a unique connection between every node in the network. The 
charlieplexed LLDs covered in Chapter ft are at] exam pic of a fully connected electrical network. 

A mesh network allows nodes to act as relays for other nodes, passing Information back and forth 
among themselves and figuring out how to get from point A to point B, right now, based on available 
routes. 
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The nice thing about Kite simple examples so far Is that they have used identical sketches on all the 
nodes. There Ls no concept of xii/dresslng or any distinction made between nodes. The idea lias been to 
get you thinking about how networks actually work, Instead of relegating all that wondrous technology 
to vague Ideas about a cloud somewhere. 

You come back to the more complicated networks (such as the Internet! later. Now, let’s take a look 
at so me of the real-world issues you encounter when dealing with networks of devices even If that 
network has a population of two. 


Making the Connection 

You now turn to some practical aspects of this little conversation between Ardulnos. First, there has to 
he a proper connection between these two aspiring conversationalists. One answer is to hard -wire the 
two devices together electrically. For the most basic serial-port connection, this requires a minimum of 
three wires. One wire carries a signal from the first device [the talker) to the second device [the listener!. 
Another wire makes the opposite connection, allowing the second unit to talk back to the first unit. A 
common ground connection must be made between these two devices, and that is the purpose of the 
third wire. 

That may sound like the simplest and easiest way to get these two parties talking, but it's fraught 
with peril. The Low voltages Involved, coupled with the relatively high resistance of thin wires of any 
appreciable length, mean that no discernable signal may be able to bridge the gap betwixt the two. h 
works fine on a desk with the two units sitting a meter or two apart. After being wired up through the 
walls and over the celling or under the floor, it may not work. Or, most frustratingly of ail, Li may work 
sometimes. 


RS-232 

One possible solution is to translate those low voltages Into higher voltages so they carry farther, This is 
the idea behind the RS-232 standard. A high voltage on the TTL- Level TX or RX pins of your Arduino 
measures in the range of 3V-5V and is called a mark condition. A spcice is a low voltage, something closer 
to ground or GV. TheTX lane stays In the mark condition while Idle and then squirts out a carefully timed 
series of marks and spaces to signify a data transmission. After the transmission is complete, the TXILne 
returns to ibe mark condition. 

Forcing the data line to a space condition and holding it longer than normal for a legat data 
transmission is called a break condition and is sometimes used to get the attention of the other end of 
the line when other handshaking methods have failed or aren't available. 

Once translated to RS-232 levels, a mark condition, Instead of being a High Logic level, is now a 
negative voltage In the range of -3V to - 15 V, and possibly as low as -25 V. Anything in this range qualifies 
as a mark, according to the RS-232 specification. Similarly, a space is translated from a Low logic level to 
a positive voltage In the range of +3V to +15V. Most PCs and RS-232 -to -TTL adapters work with voltages 
between ±5V and ±1CV, typically. 

Some PCs fudge a bit and accept OV and 5V signals, hut they're still of opposite polarity from the 
TTL-levei serial signals on your Arduino. Voltages above SV can permanently damage the AVR chip on 
your Arduino. Always use an RS-232-to-TTL adapter when Interfacing with RS-232 signals. 

Converting RS-232 levels to TTL levels Isn't hard. You can do this with a transistor, a dlude, and two 
resistors. Because one of those rcsisiors is acting as a pull up on the received signal, it can he replaced by 
the built-in pull up resistor available on [be AVR's I/O line, bringing the component count down to a 
manageable three. See Figure 12-6. 
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Figure 12-5. An RS-232-io-TTL receiver circuit. This circuit limits the voltage swing of the incoming signal 
to TTL leech (i l-SVj and provides the necessary logical inversion. 


Looking at the circuit schematic in Figure 12-6, yon see the RS-232 Input going straight into it I, a 
lOKi'l resistor. The purpose of R l is to limit the amount of current flowing to the base of QI . Yes, In 
theory, it should be a mild-mannered H S-2T2 signal, always between the mandated voltage of±15V. But 
it may not he. This is by far the most common point of failure in any electronic circuit: the connection to 
the Outside World. All kinds of Lerrlhle things are lurking out there, waiting to zap your tender creation. 
Static electricity, being plugged in backward, being plugged into the wrong device — these are just a few 
of the possible scenarios. You don't need to go crazy adding protection circuitry 10 every node in your 
invention. You do need to know where to look for the most commonly occurring failure points when 
things start acting strangely. The connections to the Outside World arc the usual suspects and a good 
place 10 start. 

Diode Dl also offers some protection forQl by keeping the base from going 100 negative with 
respect to the emitter. Bipolar junction transistors (actually, most semiconductors) have a failure mode 
called reverse voltage breakdown. Even a beefy small- signal transistor like the PN2222A, which was used 
10 drive loads up to l.QA back when you were blinking LEDs, has a teeny- Liny emitter-base breakdown 
voltage (BV ti . mi ) of only 6.0V. That means If the base becomes more negative than the emitter by as little 
as 6.0V, the transistor fails. 

You prevent this particular failure by keeping the voltage at the base within a volt or so of ground, by 
clamping [he base to ground via the diode, Dl. D 1 can he any small rectifier diode, such as the 1N414I) 
or INS 14. 

The collector of Q 1 Is connected through a pullup resistor to V . Tins keeps it at a logic High level 
until the transistor starts to conduct. 

When the input voltage of the RS-2L't2 input goes high fa space condition), this causes a small 
amount of current to flow through Rt and Into the base ofQl. Ql becomes forward biased enough to 
begin to conduct current from its collector to its emitter. This causes the voltage on the collector to drop 
10 very close {but not all the way) to ground. This produces a logic Low level on the output pin. 
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When [he input voltage of the R5-232 signal is ground or negative, very little or no current flows 
through Rl, Qi remains unbiased, and the output remains High. Tills Is the mark condition, indicating 
that the data line Is either Idle or disconnected. 

The transistor effectively fmwrb the logic level of the Incoming signal, which is exactly what you 
need it to do. It also atten nates [reduces the amplitude of} the signal in Lite process, assuming that V Is 
lower than the Incoming RS-232 signal, which Jl most likely Is. 

Listing 12-2 shows a short example sketch for an Arduino .Mega 25t>[). One of the extra serial port 
inputs (ftXU is tied to the output of the circuit In Figure 12.-4. An RS-232 signal Is attached from a PC. and 
serial data is transmitted from the PC through Its serial port to the RS-232-to-TTL adapter eLreult and 
then received on Lire Arduino Mega 2560. The received data Is then sent back to the PC via the Serial 
Monitor in the Arduino software. 

Listing, 12-1, Example Sketch to Test an RS-232-to-TTL Adapter Circuit 
void setup() { 

Serial, begin U serial aonitor 
Serial3. begin fnszoo); // from PC 

digitalHxiteflS, HIGH); // turn on puLlup resistor on KX3/D15 * required 

} 

void loopQ { 

if (SerialJ.availableO) { 

Serial .writ e£ Serial^ . read() ) ; 

> 

} 


Note that using the built-in pullup resistor works up to 1 15,200 haud hut only for very short 
distances. For longer distances or higher communication rates, please use a real pullup resistor of lOKfl 
nr so. This decreases the rlse-ttmeon the TTL signal coming from the adapter circuit. Resistors are 
cheap. 

Converting from TTL to RS-232 levels is a little more complicated. You can use a circuit similar to 
the one presented In Figure 12-7. It steals the negative voltage required to comply with the RS-232 
standard from the incoming TXD signal and stores It in Cl. 
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Figure 12-7. A bidirectional RS-232-io-TTL amverter 

A circuit very similar to the one In Figure 1 2-1 was used on the original AVRISP from Atm el, which 
used an RS-232 port for communication wlih the PC. The more recent AVRISP mkll (ah, Roman 
numerals l uses the in ore recent USB -type connection. 

If your eyeballs are starting to cross from looking at tills schematic, have no fear. There's a chip for 
that. It was originally designed and manufactured by Maxim 1C (wuu, maxim- Ic.cq*) and called the 
MAX232. Several other manufacturers also produce a similar part today. lt F s much better in almost every 
way when compared with ihe circuit in Figure 12-7. Have a look at the schematic in Figure 12-tt. 
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Figure 12-8. The MAX232 chip makes RS-232 interfaces simpler and mare reliable, while only requiring a 
single BV supply. 

The MAX232 does several things. It contains a pair of RS-232-to-TTL receivers and a pair ofTTL-to- 
RS-2.32 transmitters. It also contains a voltage doubler and a voltage Inverter. The doubler converts the 
5V Input voltage in - 1 (IV. The inverter takes the - 1 OV and converts it to - 10V. This ± l UV supply is then 
used to drive the FtS-2^2 transmitters. The MAX232 also offers 15KV of isolation* protecting your 
sensitive circuits from the harsh world. 

The capacitors surrounding the chip are required. Cl Is used In the voltage-doubler circuit. C2 Is 
used in the inverter circuit. C2and C.A arc the filter capacitors for these ±10 V supplies. CS decouples the 
input power supply, reducing the electrical noise generated by the Internal oscillators. 

For the original MAX232 device, C1-C4 should be I .O^F capacitors. For the improved MAX232A, the 
capacitors can be much smaller, only G.ijiF. The MAX2S3 Incorporates the capacitors C1-C4 internally. 

Many variations are available with different numbers of transmitters and receivers. 


RS-4B5 and Others 

RS-232 still suffers From voltage drops when Eong line lengths are Involved. Another alternative is the RS- 
4f!3 standard, where a differential balanced line is used Instead of a voltage-only interface. This 
arrangement allows a signal to Iravel much further and is also more immune to environmental noise. 
There are several possible configurations for serial communication using the RS-4AS standard, including 
multipoint arrangements in which more than two devices communicate over the line. The AYR at the 
heart of your Arduino already supports some of the more common conventions, which sometimes 
require nine data bits to transmit data and address information over the bus. 
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An Example Library 

Bill Porter's Easy Transfer library for Arduino makes It really easy and fast to communicate between iwn 
Arduinos. See bill’s web page at *r*vi. billporter. inf a /easy transfer- a rduino- library/ for more 
information and to download [tie latest version. 

The big advantage of the Easy I ransfer library is [hat all communication Is done in binary, which 
makes it a lot fas ter than if the data was being sent back and forth using ASCII codes. I [ also supports 
using both the hardware USARTsas well as the other kind using the NcwSoft Serial library. 


MIDI: Musical Instrument Digital Interface 

The MIDI standard lias been around since the earty 19fl0s. At that time, electronic musical instruments 
were increasing in popularity, but it was difficult or impossible to connect them together. The MIDI 
standard solves this problem using a simple serial connection. The standard was once freely available on 
the Web but has since been improved and can be purchased from [he MIDI Manufacturers' Association 
(wwvr.midi.org). 

A MID! connection sends control and event Information over a digital serial port. Il doesn't transmit 
sounds or audio. For example, let's say you have a nice MIDI keyboard that you've practiced on fora 
long time, so you're really familiar with it. Other keyboards are OK, but [bey don't play as well as yours. 
Tile problem Is that the built-in Instruments and sounds are getting a bh dated, and you want some new 
stuff. You buy a shiny new MIDI module that has a few buttons and knob son It, but no keyboard. You 
plug a MIDI cable land there is only one kind of MIDI cable, hut different colors and lengths) from the 
MIDI OUT port of your keyboard to the MIDI IK' port of your new module. Plug your headphones into 
the new module, turn everything on, and jam out to [he latest sounds. That's all there Is to It. It was 
designed so that even musicians could use.- it. 

In reality, a lot of [bought went Into making MIDI easy and reliable for everyone, not just musicians. 
It was literally plug-and-play before anything else was. 

The MIDI hardware interface is simple but effective. Tire underlying communication protocol lias a 
simple, basic structure; but like everything else, it has been Improved over the ages and now Includes all 
kinds of stuff. 

The keyboard describes what and how you play by sending messages to the module. To reiterate, it 
does nor send audio or sound signals of any kind. If you play a note by pressing a single key, It sends a 
single Note On message, describing which key was played (note number) and how bard you struck It 
(velocity information]. When you release [he key, the keyboard then transmits a Note Off event, also 
naming [be key involved and, oddly enough, describing how hard you released the key. True story. 

If you play a chord, the keyboard sends a series of Note On messages, one for each of the keys in the 
chord. They aren’t all sent at the same time exactly, but fast enough [bat it's almost Impossible to detect 
any delay. 

A M EL>1 port and a serial port both communicate by sending one bit at a time over a channel. 
Whereas the Arduino and PCs use a voltage Interface, MIDI uses a current loop. This dramatically lowers 
the amount of noise on the line Why don't PCs use current loops? The old -style Teletypes did, and [be 
very first .serial interfaces available for the IBM PC bad a current loop option. 

Current flowing through the loop Is perceived as a logical 0. No curreni flowing Is a digital 1. 

That is all. 

Also a wee bit different from your familiar serial ports. MIDI always uses the same communication 
race of 3 1,250 bits per second. This Is perhaps more easily remembered as 1 M I Iz + 32. The framing 
format Is SN1, or eight data hits, no parity, and one stop hit. This makes It easy to set up using the 
Ard u in 0 soft w arc : Seri a 1 . beg in ( 3 1 2 50 ) ; . 
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The hardware interface is likewise easy to build. The MIDI example sketch provided with the 
Arduino software describes a simple hardware MIDi transmitter circuit, but it isn't in strict compliance 
with the official MIDI specification, it lacks only a single resistor to he fully MIDI-compliant. To 
paraphrase and correct: 

■ Connect digital pin I (TX) through a22Ui‘i resistor to MIDI pin 5. 

* Connect M IDI pin 2 to gro u n d . 

* Connect MIDI pin A through another 22GD resistor to +5V. 

Let's take a look at this MIDI connector, it's a 5-pin DIN modular connector with a LflO* pin spread, 
sometimes known as a Si ISO 4 . These were once used as shielded audio cables. You might also remember 
them from such all-time favorites as the original IBM PC keyboard cord. MIDI cables always have male 
connectors on both ends, and all MIDI equipment has female sockets. See Figure 12-^. 




Figure 12"$. The business end of it MIDI cable. The pins are numbered, left to right: 1.4.2, S r ,'i. There Li an 
alignment much in the bottom half of the shield. 

[f you can't find a proper MIDI socket for your experimental purposes, you can always chop a MIDI 
cahEe in half. There can be as few as two wires and a shield inside, or all five pins may he connected. The 
pins are wired straight across: pin 1 goes to pin I, and so on. 

The shielding within the cable is connected to pin 2 (the center pin) on both ends of all MIDI cables. 
The MIDI OUT port should connect pin 2 to the local ground. To eliminate die possibility of ground 
loops,, the other end of the cahEe (the MIDI IN port) does hot connect pin 2 to ground. It Isn't required to 
complete an electrical connection, as you did previously using TTL serial communication, it only serves 
to shield the pair of wires inside. This is sometimes referred to as a telescoping ground. 

The two other pins, A and 5, form the two legs of the current loop. By connecting the MIDI cable to 
your Arduino as outlined earlier (the Arduino MIDI example sketch omits die 220s'l in series with theTX 
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pin for some reason), when t h e TIL level of the U S ART goes to .tern [logical Low), then current flows 
through [he loop. When the TTL level rises to +5V, there is no difference in potential, and no current 
flows through the loop. 

On the receiving end, [he two wires are connected to the LED portion of an opto-lsoEator. Well, 
they’re supposed to be. Some vendors cut comers and don’t Isolate the signal on the receiving end. This 
violates the MIDI specification and most likely adds a terrible amount of noise to the system. 

An op 10 -isolator works by having two isolated circuits in close proximity to each other, and cut off 
from ambient lighting. Inside these little chips is a small cavity with an LED on one side and a 
phototransistor on the other. They aren't electrically connected In anyway. They're optically coupled, 
meaning that when the LED conies on [that is. when current flows through it), the emitted light forward- 
biases the phototranslstor. causing it to conduct more current than in the dark condition. That makes 
these devices perfect for current -loop applications. 

The phototransistor side of the circuit then typically pulls a signal down to ground when activated. 
The signal floats hack up when no signal is present due to a pull up resistor connecting It to V lT . You work 
with the receiver part shortly. For now, let's make some MIDI noises using an Arduino. 

The Arduino example MIDI sketch is a good starting point: File > Examples > A. Communication > 
MIDI. However, it gets old quickly. Try the sketch found in Listing 12-3. 

Listing 12-3. Arduino MIDI Keyboard 

Sdcfine KEYS* 4 

volatile byte previous_statetKiY6] ; 
volatile byte state[KE¥S]j 
vo Utile byte changes [KEYS] ; 

const byte key_pins[kEYSl = { 5 , 6, 7, 4, 9, 10, ll, 12 }; 

const byte notes l KEYS] = { 60 , 62, 64 j 65, 67, 69, 71, 72 }; // middle C and up 
void setup() { 

for(byte i - &; i < KEYS; i++) dlgitalwritc(key_plns[i3, HIGH)] // pullups cm! 

Serial. begin (3 12 50 H MIDI special baud rate 

TCCR2& = 0< CWGH22 | 1C<CS22 | K<CS2t | 1<<CS2Q; // Ck/1024 

TIMSK.2 = l^TDIEZ; if enable overflow interrupt 

} 

void loopt) { 
byte i; 

for(l = 0; i < KEYS; I++) { 

If (changes[ i]} { 

Ser ial,write( statef i] ? 0 x 90 : 0x40)j // Note On or Note Off, channel 1 
Serial. write(notes[ij); H the MIDI note number 
Serial. wrlte(0x64) ; // mediua velocity 
changes[ij = dj fi done! 

} 

> 

} 
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m(TIMER2_GYF_vect) { 
byte i; 

// scan the buttons 
for(i = o; i < KEYS; 1+*} { 
previuus_state[i ] - state[l]; // save previous state 
state[i] = digitaLftead{key_pinsIi]) ? 0 : l; If record present state 
changesli] = state[ll " previous_state[ i] ; if any changes? 

> 

} 


You need in add some pushbuttons to digital pins 5-12. Sec Figure 12-10. 



Figure 12-10. An Arduino MIDI keyboard, ttsi/ig a harvested MIDI cable flower left ) 

The sketch Looks surprisingly simple, hut it s doing some interesting things on [he Inside. Let's take 
a Ino k a t what ' s go Lng o n. 

You Sdefine a constant, KEYS, for die number of keys you want to use. In tins case, it's eight. This 
number crops up several times In the sketch, and it would be cumbersome to change them all If you 
decided to add or take away a few keys. 

Next are some volatile byte array declarations. You use those to keep track of the states of the 
buttons musical instrument keys. You declare them as volatile because they're manipulated by an 
interrupt handler, and you don't want the compiler making any sort of assumptions about ihelr 
contents, which It would otherwise do. 

After that, you have a couple of look-up tables Jn [he Form of const byte arrays. The first one, 
key_pins[ J, tells you the pin numbers associated with each of tire keys. Similarly, tire notes[] table 
assigns a MIDI note number to each of the keys. MIDI note numbers can range from Ota 127, with 
middle C being number 60. You assign the white keys from middle C and up an octave to the little 
keyboard. 

The setupE ) function first turns on ail the built-in pullup resistors that are connected to ttie buttons. 
It does this in a compact for [) loop ibat iterates through all the Items in Lire key_pins[] look-up table, 
using the digit a Write () function to set the outputs to a HIGH level If they were outputs. But they're not 
outputs: they remain inputs because you didn't specify otherwise. 
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The Serial , begin ( 31250 ) function call Is the only MID I -specific hardware con fig u ratio n you need 10 
perform. Everything else goes toward learning to speak MIDI properly and scanning the keyboard. 

Timer/ Counter 2 Is used to generate a periodic interrupt. You set the prescaler to divide by 1,024. 
giving the fl-b.it counter a 1 6,6251 Iz clock. Because Timer/ Counter 2 remains mostly configured for PWM 
service by the loiv - level Arduino code, this re suits in an overflow about 30 times per second. You enable 
the overflow Interrupt by setting the T0IE2 hit in the TiMSKi register. Global interrupts have already been 
enabled for you. 

You define ait interrupt handier for the Timer /Counter 2 overflow interrupt using the mandated 
vector name TIntfi.2_0vF_vec:t. In this Interrupt handier, you again iterate through the keys. First, the 
present state (pressed or not pressed) of each of the keys Is copied to a prcvious_state[ ] array. This 
helps you decide what, If anything, has happened. 

Then the state of each of the keys is interrogated using the digital. Read ( ) function, hy using the key- 
to-pin Eook-up table. Additionally, the HIGH and LOW values returned hy the digitaLReadQ function aren't 
realty what you want, although they would certainly do if you wanted to keep rrack of them that way. 
Instead, you use the return value iHlGRor LOW] from thedigitalWjrltef) function as a irue/false tesi, 
usi n g th e C co n di t Lo nal 0 pera tor? r . Th e f i rst va! ne follow! n g the ? as retu rn ed if t h e co ndl t ion is tru e; 
otherwise ibe value following the : Is returned. This lets you arbitrarily assign a value of one In the 
state[ ] array if the key is currently being pressed and zero otherwise. 

Next the present state and the previous state are compared using the exclusive- or function. If 
they’re the same [still pressed or still released, you don't care which), this returns a value of zero 10 Lhc 
changes [ ] array for this key. Only if the state has changed (again, you don't care which wayj does the 
changes [ ] array Indicate that something happened. 

This keyboard scan happens just over TO times per second. 

The LoopO function continuously looks through the changes [ ] array to see if a key lias been either 
pressed or released. These are the only things .MIDI cares about, ai least as far as ibis simple example 
goes. 

if a key has recently changed staius. you send a MID] message to a MIDI synthesizer of some sort to 
play the actual musical parts. MIDI messages arc made up of one or more eight -bit transmissions. The 
first byte is the status byte. 1 1 has bit 7 set to Indicate that It's a status byte. All other bytes following the 
status byte must have their bit 7 cleared. This limits many MIDI variables to aG-127 range, such as note 
number, mentioned earlier. 

if the key was just pressed, you want to send a Note On message. This message has a status byte 
starting with 9 and ending with the MIDI channel number, assuming hexadecimal notation. 

There are lb available MIDI channels that can he addressed over a single MIDI cable. Although the 
channel numbers are shown as I through 16 to the human types, inside the computer parts the channel 
numbers are 0—15. To send a Note On. message on MIDI channel l, the correct status byte is 0x90. 

After the properly formatted Note On siatus hyie has been sent, site MIDI module expects both a 
note number and a velocity report. The velocity is a measure of how hard the note was struck. This only 
applies 10 dynamically expressive instruments, bui that is most of them. 

Your sketch sends either a Note On or Note Off message, depending on the srate of the key in 
question. It then transmits die appropriate note number, having looked It up from the table. A fixed 
velocity of 0x64 is sent along to complete the message. At this point, the MIDI module receiving litis 
message (which could be your PC if you have a MIDI adapter available] should start or cease to play the 
note, depending. 

Alternately, you can send the equivalent of a Note Off message by sending a Note On message with a 
vein city of zero. 

Because the loopO funciion is an no way synchronized with the background keyboard scan, It goes 
ahead and clears the flag in the changes [ J array to prevent it from acting on il in its next iteration. 

Now you have an Arduino that thinks it’s a keyboard. This keyboard-scanning technique can be 
used in a lot of user-interface applications. 
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The Internet 


As delivered, your Ardulno isn't ready for Internet connectivity. It's not far off, [hough. Believe It or noi, 
you're only an Ethernet adapter away from surfing the World Wide Web or serving up your own web 
pages with your humble little chip. There are two popular ways to go about this. 

The standard Ethernet Shield for Ardulno Is based on the WIZnet 5100 chip. 3 e plugs into the 
Arduino Uno like any other shield and has an Ethernet jack on one edge. 1 The standard Ethernet library, 
as supplied by tire Ardulno software, has several example sketches, including both a WebCllent and a 
Webserver application. So plug, [dug, click, upload, and you Vein the web business. Wot complicated at 
ail, and almost a little ton easy. 

To make it more interesting, let's use a different Ethernet adapter, the Microchip ENC281GG. This is a 
single-chip driver lhat connects directly to an Ethernet Jack (the kind that already has the isolation 
magnetics built in) and comes as either a shield or as a separate module. The module is the least 
expensive route and ean be had for as little as $ 1 0-$3!5, which is less expensive than ihe WIZnet -based 
solution. 

For some reason, although the Microchip part number of this chip Is EMC2!i|fi[), several vendors 
refer to their Ethernet adapter modules as EN2ai60, without the C.. This carries over to the 
documentation and into the driver software, as well. 

One of the simple reasons that the ENC2flJ6f) device is less expensive Is that It does less. The WIZnet 
device implements the U DP and TCP protocols on-chlp, relieving the Ardulno from handling those 
tasks, which are moderately complex. However, never fear: the Arduino community of generous and 
clever folk to the rescue! Several Ardulno libraries are available to talk to the ENC2&16Q chip. You can u&e 
one of these and pick and choose what you require from the feature set. Listing 12-4 shows an example 
sketch that presents a static web page on a fixed IP address. 

Lining 12 -4, Arduino Web Server Example Sketch* Boiled Down to a Bare Minimum 
if include 'EtherShield.h" 

Ether Shield es; // the EtherShield "object" 

// please change these numbers! 

byte mac_address[] = { 0x04 * 0x07 , oxen,. 0x09, oxo6, 0x03 }; 
byte fp_address[] = { 192, 16&, 0, 99 

Sdcfine BUFFEft_9I2E 1000 // make it 500 for '164-based Arduinos 
by te pa ge _b offer [BUFF Eft SI Z E ] ; 

const char webpage_contents[] PRDG.HEM = 

"HTTPyi.Ci 2:00 DK\r\nContent-Type: text/html\rVn\r\n" 

*<html><head><title>Arduino EN23J60 Web Serverx/titleiK/head>t body>" 

'chi>Arduino Er<28>bO web Scrverc/'hi^" 

’^p>¥up, it works. </p>" 

"<p>Simply amazing L</p>" 
w <hx />" 

"c/bodyx/html> n ; // The End. This line must have a semicolon at the end of it 
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void ittupO { 

cs = EtherShield(); // create the EtherShield ’object' 
es. E£_enc2&jfrQlriit(mac_,addre££ ) ; // initialize EN2636G 
es, ES_init_lp_^rp_udfj_tcp{ma!C_addreii J . ip_address, So); // use port So 

} 

void loopQ { 

if fes. E&_paekotloop_iarip_tcp(pjgc_buffor J es, ES_enc28j6QPacketfi.eceive(6uf-FER_SI2E , 
page_buffer))) { 

// send web page contents if HTTP request received 

es , E i _www_s er ver _r eply {page_bu f f e r , cs . E £_ f il 1 _t c p_dat a_p { page_b u f f cr y 0 , 
we b page_c 0 n tent s ) ) ; 

> 

} 


This example sketch is derived from the web -server example provided with the EtherShicld 1.6 
library, available from http://blog.thiscldo.CD.uk. The EthcrShield.h header file Is included in the 
sketch, which defines the functions available. The os variable is declared asao instance of an 
EtherSh leld object and created In the setup[) function. After that, tbe EN2ElJ(!() chip is Initialized with its 
MAC address, and the library Is configured to perform a variety of web-related tasks, intplemeoting 
several of the underlying protocols necessary for web pages to he served. 

A buffer is reserved for both sending information to and receiving it from the Internet. This buffer 
can be as large as 1 ,t>00 bytes on the Arduino Uno. but it should work better at around 500 bytes for 
AT mega 1 (Pi - based A rd li i no s. 

A const char array of bytes is placed in program meniot y using the PRCKjMEM keyword. This array 
bolds the conteots of the web page 10 be delivered upon request front someone's web browser. You use a 
little C coding trickery here. Notice that each of the lines of HTML code is contained within matching 
double quotation marks, hut no connecting punctuation Is used between them. The compiler 
concatenates these strings together into one big string, lust remember to put a semicolon at the end. 

If you're familiar with HTML, the contents of the web-page definition should look pretty 
predictable. The only additional Items are the HTTP headers at the beginning. These are transmitted 
back to the requester (usually a web browser) as part of the data negotiation that takes place every time 
you look at a web page. If you’re wo/yet fatniliar with HTML, now Isa good tune to get started. 

Tbe test of the web page is the bare minimum required fora well-formed HTML document. A 
chead> is defined, where ibe page title Is stored. The cbody^ of tbe web page contains a single ^hi> or 
first-level beading, again repeating Ibe page's title. A couple of short <p> paragraphs follow, ending with 
a <lu /> horizontal rule, or line. Feel free to replace the contents of this example page with whatever 
wonderful prose you like. You could even link to a funny cat video, in keeping with tbe original purpose 
and traditions of the Internet. 

The real magic happens in the deceptively- short laopO function. A call to a library function wails 
for an Ethernet packet to arrive. This packet's content is then examined. If it's an Internet Control 
Message Protocol (ICMP) or control packet, such as a ping request, it's handled. Iflhe packet contains 
an HTTP GET request, then the page buffer is filled with the contents of the statle web page [preceded by 
the HTTP headers, of course] and shipped back out the Ethernet port. Deceptively simple, yes? 

The reality Is that there are many, many layers of protocols hidden beneath this simple loop. Tbe 
EtherShleld library is handling the uppermost layers, and the Ethernet module Is handling the lower- 
level stuff. All thLs in a sketch that is only about (5KB. Thai leaves quite a bit of room for more fun stuff! 

Wiring up the web server is pretty simple. If you build or buy the EN 28} SO Ethernet adapter in 
Arduino shield form, all you have to do Is mate It to your Arduino, and the wiring is finished. Connect the 
RJ-45 jack to your router with an Ethernet cable, and you’re all set. 
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If you' re using the smaller EN 28160 adapter module, it's still pretty easy to wire it to your Arduino 
Uno. See Figure 12- 1 1 (schematic) and Figure 12-12 (photo). Only six wires are required. 

Note that this only works reliably with the Arduino Uno and later hoards that tan supply 150mA of 
current on the 2.3V lute. The earlier FTDI-based Arduino boards are much more limited Lit their ability to 
provide regulated 3.3V, which Is what the EN2SJ60 module requires. For those older boards, or 
derivatives that lack a 3.3V regulator, an external 3.3V regulator Is required. 
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Figure 12-11 The schematic diagram of she Arduino ureb server, using the inexpensive EN28J6Q Ethernet 
module. Only six i vires are required. 



Figure 12- 12, The Arduino web-server prototype, with high-tech mounting option 
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Figure 12 - ITS shows the mostly unimpressive output of all this tinkering. 
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Figure 12-13, The web page delivered by ike Ardtilna web server. Nat m uch, but a goad start. 


Summary 

An Ardulno that doesn't get to talk to someone gets bored, li could he another Arduino sitting on the 
table right next to Jt, or It could an Ardulno on another planet. For all you know, It could he some (gasp!] 
non-Arduino computer that wants to hold a conversation. Anything Is possible with the proper 
networking, fust decide what you want to talk about, and get to talking. 

This chapter covered only a few of the really basic ideas Involved with networking. Space limitations 
preelude Including all the great projects that can easily use the Arduino’s various communication 
peripherals. This gives you some Ideas ahnut how to get more than one computer to communicate and 
maybe even cooperate toward accomplishing a task. 

Rear In mind that when the now-popular World Wide Web was first getting started in the early 
ilftSOs, it was mostly connecting a hunch nflntei3SS r arid first-generation Pentium processors that 
were running between ItiMUxand 60MHz. With high-speed broadband Internet access spreading 
across the world at an ever-increasing pace, it seems Inevitable that all things electronic will soon be 
able to talk to each other, creating an Internet of things. You have the opportunity to help decide what 
these things can and should do. Jlow will your next Arduino networking project affect the world? 
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More Example Projects 



So here- we are Jn [he very East chapter of the book. Lei's take something you've learned from each of the 
previous chapters and build a little Arduino- based, project out of it all. What shall you build? 

How about a robot? Robots are an excellent second Ardulno project because they usually Involve 
more than one active, working system. This Involves a certain amount of planning ahead of time, as well 
as having a good Idea when one of the subprojects is working well enough to he able to move on to the 
next sub project. 

Like any other complex idea or task, designing and building a robot of your own can be divided Into 
many smaller projects. Each of the mini projects Ln this chapter has application In other areas, and not 
just in personal robotics. This Is one of the excellent benefits of rob otic engineering, both as a hobby and 
as a profession. U forces you to approach [be problem as a whole with a multidisciplinary viewpoint, 
requiring proficiency in several arts and crafts and a keen sense of how 1 all the various parts will come 
together as a single, working unit. 

Many topics and lots of interesting lidbhsare covered in the briefest and shortest manner possible. 
One chapter in a book won’t teach you everything you need to know about designing and building 
successful robots. The intention is to whet your appetite and spark your enthusiasm, while showing 
some actual robot designs that you can use as a launching point. 


An Autonomous Robot 

What defines an autonomous robot? It's a robot that can interact with its environment independently, 
with little or no human control required. Let's stop Just shy of giving It complete free will, emotions, and 
flame throwers for now and see what kind of problem -solving skills you need to get something going. 

As previously mentioned, there are several interrelated systems working together within even the 
simplest robot design. An autonomous robot, If it's 10 operate Independently and without tethers, 
cables, or trailing wires, must have its own power supply. This power supply must meet the Immediate 
needs of the robot, must permit lengthy periods of activity, and should be replenishahle, ideally under 
the robot's controL It needs a motive system and perhaps some additional articulation. A sensor him of 
various detectors and sensors should provide the robot with data about Its Immediate environment. All 
of these systems must be coordinated by an Internal control system tEiat should at all times remain 
compliant to your wishes. 

OK, let's get started! I low hard could it he? You look at each of the major subsystems Ln a little detail 
and then move on to an Iterative process of experiment and refinement. 
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Power Supply 

Several types of power can be utilized in a robot structure. The first that may come to mind Is electrical 
power, to run the computer chips and electric motors. Many small-scale robots rely entirely on electrical 
power. Compressed air, hydraulics, fuel cells, solar pastels, steam, tightly wound springs, and gravity can. 
also be used, depending on your facility with these technologies. 

Because it's completely predictable that you're going to use an Ardulno of so me sort along the way, 
you should make at least preliminary plans for providing electrical power in the robot. 

The typical Ardulno lino or similar circuit requires a steady stream of regulated electrical power to 
operate reliably. The on-board voltage regulator on most store-bought Arduinos permits you a certain 
amount of latitude when It comes to the specific characteristics of your supply. Anything between fiV 
and 12V should do nicely. Only a small amount of current Is required for the microcontroller and 
supporting circuitry. The large-scale power consumers are typically the sensors and electric motors. 

For anything except the teensiest, tiniest motors, you're strongly encouraged to Implement a 
separate power supply for use by electric motors. These devices characteristically draw wildly varying 
amounts of current, depending on the demand placed on them. Maintaining a particular motor speed 
requires surprisingly little current, hut getting to that speed requires a correspondingly Large amount of 
current. 

The principal symptom you encounter that Indicates it's time to move to separate, dedicated power 
supplies is when your Arduino begins to act even more erratically than normal. This is most likely caused 
by giant current surges from the motors attempting to accelerate, which produces a corresponding drop 
in supply voltage to the AVR. Below a certain point, the AVR goes into a self-imposed reset state to 
prevent unreliable operation, and It remains there until the supply voltage returns to a safer level. 

To run at the full clock rate of 16MHz, both the ATmega32fl and the ATmega2560 require from 4.5V- 
5.5V of well-regulated power. The voltage requirement drops substantially with lower clock frequencies. 
To achieve lower frequency operation, you have several choices. You can swap the quartz crystal or 
ceramic resonator for a component of a different value, which can be tricky. Alternately, it's possible to 
change the fuses to use either the Internal tkOMIIz R C oscillator or [he 12ftKllz RC oscillator, although 
neither of these Internal oscillators is particularly accurate. Another option Is to program [hetKDIVa fuse 
to divide the 16MHz quartz crystal oscillator down to 2MHz. Finally, and least Intrusively, you can leave 
the clock hardware alone and reduce the system clock using the system clock prescaler, which offers 
divisors between 1 and 25fi. 

Lowering tire clock rate lowers the minim urn voltage requirement. You can then entertain [he Idea 
of running the electronics directly from a battery, such as a single lithium cell (3,7V) or a bank of 
between two and four nickel cadmium (NiCD] or nickel- metal hyd ride (NIMH) rechargeable cells (2.4V- 
4.6 VI . 

For very preliminary designs, you can depend on a very small amount of power being made 
available via the USB connection to your PC. With the right Interface circuitry, the power from your USB 
connection can Ire used to recharge the robot's battery, assuming it's a small one. Remember, there are 
only 2.5 watts of Juice coming through that cord. That may sound like a lot, hut It's realty not. 

Power-supply design for any mobile platform Is a study in both robustness and efficiency. Milliwatts 
saved equate to extended runtimes. A reliable power supply eliminates one of the variables when 
at kvmpj tin ;j. Li) (Uainiusv iinut brlnnuu al uddilirs and vcivcti ifi . 


Motion Control 

You can use a couple of small electric motors to scoot a little rohot around on the floor, and maybe 
throw in one or two more to operate a primitive gripper or arm -like mechanism. On the other end of the 
spectrum, you can design and build arrays of powerful servos that fully emulate a humanoid. Your first 
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robotic experiments ought in be somewhere In between. To guarantee that you build your skill set 
rapidly and effectively, it's recommended that you move from one successful project to the next. Now to 
do ilhii r it's best to start out with baby steps, learn from your mistakes what works and what doesn't 
work, and then apply that hard-won expertise in the next design challenge. 

As you might expect by now, there are several technologies available to imbue a robot with 
movement. This decision Is based on requirements, cost, and physics. Does your robot want the ability 
in move Itself around freely, nr can it stay mostly In one place and manipulate objects within its reach? A 
mobile robot is much more challenging to design and build than a stationary one. A wheeled robot is, in 
turn, easier to design and build than a walking one. Flying robots are becoming more prevalent among 
the hobbyist comm unity, showing surprising dexterity, accuracy, and robustness. Many of the smaller 
flying robots are controlled with a single AVR processor, such as quad copters. 

Before you fly, you must crawl. Even crawling requires controlled motion, and not random failing. 

The key point in motion control isn’t motion but control. All robot motions must be controlled. This 
implies several Important ideas that many, many books would lack the space to cover In their entirety, 
hut you explore a few of the major ones: 

* It’s never too early to start thinking about safety. 

* There should be a well-defined Intent associated with every robot motion. 

■ Any motion performed should he measurable,, or at least verifiable. 

* Llm Its to mo t lo n ma y be req u ired a n d m ust lie respected, wh en i m pic me n ted. 

* Fi na lly , it's n ever too ea rly to st art till nki n g aboti t sa fe ty . 


Electric Motors and Actuators 

Let's look at a few of the many available types of electric motors and actuators that you can use In a 
small robot project. Ilach has its own unique qualities, abilities, requirements, and drawbacks. 

These are only introductory comments about the following motors and actuators. Excellent 
references exist for the asking that describe the underlying theories as well as practical applications. The 
hope Is to expose you to enough lo formation to help you make a better-informed decision when you 
decide to Invest in a particular technology. 


DC Motors 

The modern DC motor is a marvel of engineering. It turns direct current IDO voltage Into rotary motion. 
It does this efficiently and relentlessly. How does it perform these apparent miracles? Just like any other 
trickster: with the clever use of magnets. 

There are many kinds of DC motors, but by far the most common these days Is the permanent 
magnet variety. This is the kind of motor you find in inexpensive toys, so they’re often referred to as toy 
motors. 

In tire most basic type of permanent magnet DC motor, there are two magnets that arc fixed in 
place. A rotating shaft spins between the two magnets. On the shaft Is a coil that is typically wound 
around some soft iron plates. When a current flows through this coll, It becomes an electromagnet, 
which causes the freely rotating shaft to turn, trying to align the poles of the electromagnet with the 
poles of the fixed permanent magnets. If it were not fora bit of mischievous electrical wiring in tire 
motor, the coil would line up with the magnet and stick there. The trick Is that the wiring to the coil Is 
threaded around the shaft, making contact with the spinning shaft through a pair of spring-loaded. 
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conductive brushes. As the shaft rotates, the brushes lose contact with the coil momentarily and then are 
reconnected, but this time In reverse. Tills causes the electromagnetic field to reverse polarity, now 
causing the electromagnet to repel away from the fisted permanent magnet. Because of the Inertia 
previously imparted un the shaft from the previous magnetic attraction, the shaft continues spinning in 
the same direction, which brings it around to the opposite side of the motor from whence it started. 

Then Lhe whole process repeats, as the current Is again reversed by the clever arrangement of the 
brushes and the coil wiring. 

This process of alternating the currents and magnetic fields Is called commutation. It’s done with a 
clever combination of mechanical and electrical components in the motor, so all the user has to do Is 
apply a DC voltage and the motor spins. Remove the voltage, and the motor coasts to a halt. Reverse the 
current, and the motor spins In the opposite direction. It couldn't be simpler to use. 

Because even the smallest commonly available DC motors requires dozens or hundreds of 
mill Lamps of current to operate, they can't be directly connected to the I/O pins of a microcontroller. A 
driver circuit of some sort must be used. 

The most basic control circuit turns the motor on or off, in effect operating as an on /off switch. 
When the switch is on, the motor spins. When the switch is off, the motor coasts to a stop. The motor 
spins only in a given direction. Reversing the motor requires a more complex wiring arrangement. 

One such arrangement is the addition of a double- pole, double throw fDPDTj relay that reverses the 
current going to the motor. With the use of the basic on/off switch and this direction-control relay, the 
motor cat) be run forward or in reverse, as well as brought to a ball. This requires two i / O lines: one for 
the on/off switch and another to control the relay, which will also most likely require a driver circuit to 
operate. 

By pulsing theon/off switch quickly, a la puise-width-modulaiEon (PWM), you eat) achieve variable 
speed control of the motor. This Is because the speed of the motor is controlled by the applied voltage, 
whereas the torque, or twisting force, Is controlled by the current flowing through the motor. Because 
the average voltage across the motor can he manipulated with PWM, you can use this as a way of 
controlling the motor’s speed. 

One additional driver that can he used to give a wide range of control over a DC motor is an 13- 
bridge circuit. It's called this because the motor is attached between two half 1 1 -bridges and the resulting 
wiring diagram resembles a capital letter II. 

A half H-brldge circuit has a switch, relay, or transistor to connect to a positive voltage and another 
such switch to connect to a more negative voltage. This allows a low-power signal such as cat) be 
generated hy a microcontroller to switch one terminal of the DC motor to either a high voltage or a low 
voltage. By placing another such half I I -bridge circuit on the other side of the motor, you can achieve 
both forward and reverse spin of the motor. By modulating some or all of the control signals to the H- 
bridge, you can accomplish variable speed and bidirectional control of the motor. 

If both terminals of the motor are connected to the same voltage, the motor is effectively braked. It's 
not Locked rock-solid, but It’s more difficult to spin Lite shaft under these conditions. 

It's also quite possible to program an II -bridge clrcuLi to self-destruct If appropriate precautions 
aren't taken. This happens when both the upper and lower portions of one half I [-bridge are engaged at 
the same time, causing a condition known as shoot through. These combinations are often humorously 
labeled fuse test. 

You can also use any number of possible combinations of these techniques effectively to control the 
speed and direction of a DC motor. The selection will mostly depend on your familiarity with the 
different options as well as the availability of the proper components to build the required controller 
circuits. 

DC motors often spin at a rate of several thousand revolutions per minute ( RPM). This makes them 
unsuLted for vehicular motive applications unless an Intermediate gear reduction is introduced. Typical 
wheel rotational velocities are in the 2 5 to 2!5U RPM range. The actual land speed is then dependent on 
the wheel diameter. 
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Brushless DC Motors 

The limiting factor In [he life expectancy of a typical DC motor Is the inevitable wear on the h rushes. 
These components must both carry electrical current (Intermittently,, with possible arcing] and hear up 
tinder constant friction as the motor shafts spin. Iligher-quallty DC motors have replaceable brushes, 
but these are by far in the minority. 

To solve the problem of the brushes, a i?rusjttes£ motor design is used. This type of motor Is 
inherently more reliable in operation and subject only to the ravages of time in the form of thermal 
ah use ('overheating) and mechanical wear of the internal bearings. 

The disadvantage of this simpler design is that live required commutation must be performed 
externally to the motor itself. This can be done mechanically, but it's much more commonly 
accomplished electronically, with a specially designed motor-driver circuit. 

A simple hrushtess motor has three or more Independent tolls. The colls are typically wired across 
three terminals, forming a triangle. An [[-bridge drive]- circuit Is connected to each motor terminal, and a 
sequence of pulses Is sent to the motor from a controller. The specific sequence determines the direction 
of rotation. 

Some brushless controllers require rotation sensors to he mounted to the motor to provide the 
necessary feedback. Other controllers measure the haek-EMF (electromagnetic force) generated by the 
idle coil to determine speed and direction. 

The controller logic Involved can become quite complex, especially in high -performance designs. 
Luckily, the popularity of DC brushless motors in the model car and airplane hobbles has resulted In 
very reasonably priced electronic speed control (ESC) drivers that respond to a simple pulse control, 
similar to the hobby servo motors described shortly. This makes them very easy to Interface with 
microcontrollers, and they're finding their way into more autonomous vehicles every day, of both the 
rolling and the flying varieties. 


Stepper Motors 

A stepper motor is very similar to a DC motor hut lacks a commutator. Although a seemingly infinite 
variety of stepper-motor technologies exist, the hasie theory of operation Is similar. 

As mentioned in the section on DC motors, without the trickery of a commutator in tlte circuit, the 
shaft would rotate to a point where the magnetic poles were aligned and then stick. This is exactly what a 
stepper motor does. It moves In discrete steps, with each step representing only a small angle of 
rotation. The number of steps per revolution of the motor shaft is determined by the geometry and 
manufacture of the motor. Typical values run from 24 to hundreds of steps per revoluiion. 

There are generally two or more coils Involved in a typical stepper motor. The most commonly used 
varieties among hobbyists are referred to as unipofor or bipolar steppers. 

A typical unipolar stepper moior has four colls. One lead of each of the four coils Is ties to a common 
terminal. The other ends of the four colls are brought out of the motor separately. Most but not all 
steppers with five wires a re unipolar stepper motors. 

Ry applying a positive voltage to the common terminal, the motor shaft can be stepped by 
selectively grounding the other Leads of the coils In a particular sequence. Reversing the sequence 
reverses the direction of the steps. You can also perform half- stepping by energizing two colls at once in 
between the single coil steps. MicrosteppJng of a stepper motor can be accomplished by varying the 
current through the various coils, a (though litis starts to get a little complicated and Is mostly suited for 
precision placement devices, such as computer numerical control (CNC) machines. 

The primary advantage of unipolar steppers is that they're easy to Interface. A single transistor per 
colt is typically all that is required. The disadvantage is that because current only ever flows In a single 
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direction with a given coil, twice as many coils are needed, and at least two of tile four coils (in a four- 
coJt stepper] are always inactive. 

A bipolar .stepper can have as few as two coils, which are electrically isolated from each other — that 
is, they have no common terminals, A bipolar stepper with two coils requires an il-bridge circuit on each 
coJL This a Hows the motor-controller logic to drive current in either direction lor not at all) through both 
colts at once. Again, a specific sequence of coll excitations is required for stepping in one direction, and 
reversing the sequence causes the . steps to go in the opposite direction. Most but not ali four-wire 
steppers are bipolar stepper motors. 

The most critical electrical characteristic of a stepper motor is its maximum current-handling 
capability per coil. Each coil also lias a characteristic impedance. If a voltage rating is stated, its the 
product of the current and impedance, and not a maximum value. You can use more volts than are 
printed on the label of a stepper motor (nice when they do that!) or stated In the manufacturer's 
datasheet, but you cannot exceed the current rating. 

The Arduino software comes with a Stepper library that works with cither unipolar or bipolar 
steppers. Example sketches are also provided, along with connection diagrams In the embedded 
reference material that accompanies the software distribution. 


Servo Motors 

Technically, almost any kind of motor with u built-in feedback control can be termed a seruo motor, 
being a particular type of servomechanism. This means you give the motor an instruction, so to speak, 
indicating what speed, acceleration, or position (among many possible things) you desire it to obtain, 
and il knows how to do that. Servos are excellent choices for positioning systems and other high- 
precision applications. 

As mentioned, a servomechanism of any sort uses feedback to correct its behavior. A motor, for 
example, can he configured to maintain a constant speed, even under varying Loads, by measuring its 
own speed and comparing It to a set point , which is the desired speed. The difference between the actual 
speed and desired speed is the error. The amount and polarity of the error (too much? too little?) Is used 
to adjust the speed control of the .motor automatically. 

Servo motors come in all sizes and configurations. Again, thanks to the popularity of model cars, 
boats, and aircraft, small but powerful servo motors are available for relatively reasonable prices. An 
additional bonus derived from their popularity is a standardized convention for controlling those 
motors, no matter what their intended application. 

The typical hobby or RC (which stands for either remote control or radio control, depending on who 
you ask) servo motor contains a small DC motor, a gear-reduction mechanism, and some built-in 
electronics to control the whole thing. Due to the gear- reduction added to the small DC motor, the 
output of the servo motor has a great deal of torque for Its small size. Also, the total rotation of the 
output shaft Is generally constrained to between 90° and 180° of mechanical movement. This is more 
than adequate to steer model cars or boat rudders, or to adjust the control surfaces on a model airplane. 

The output shaft Is Internally attached to a potentiometer that Is used to report the present angle of 
the output shaft to the controlling electronics. The built-in controller compares this position with the 
desired position or set point indicated by Lis Input controller. If there Is a difference between these two 
values (the error term), Lite controller spins the DC motor In the correct direction to bring the two values 
into alignment. 

The standardized control input Is a pulse of varying width that is repeated at a given interval. A 
typical servo motor twists the output shaft to the far right (as viewed when looking at the face of the 
motor) If It receives a pulse 1.0 millisecond in length. A 2.0 -millisecond pulse twists the shaft to the other 
extreme on the far left. Any position between these two limits can he represented by a pulse width of the 
proper ratio. For example, to center the output shaft, a 1.5ms pulse Ls sent. 
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The 1 .D— 2.0ms pulses are typically characterized to move a servo’s output shaft 90°. A standard servo 
has hard, mechanical limits built Into the final red action gear. Untiring the overall sweep in Iftfr nr less. 
These extreme points can be reached with proportionally over- or under-sized pulses (cl. Oms or >2 0ms] 
hut are executed at the peril of the output drive train. Pushing servos past their mechanical limits causes 
them to bind, stalling the internal DC motor, which then draws what seems like (nr is, for larger servos) 
an enormous amount of current, possibly overheating the servo or permanently stripping the gears. 

These pulses are expected to be repeated approximately SC) times per second, or once every 20 
in ill [seconds. The exact update rate isn't critical. An update frequency that Is too low allows the servo to 
periodically go slack, causing it to yield its position to an applied force. Too fast an update rate can cause 
servos to chatter. No pulse at all causes the servo to de-energize the motor and make no adjustments. 

Normally, the spllned shaft is attached to one of several types of interchangeable servo frorHsand 
secured by a screw or bolt. These horns usually extend away from the center of the shaft and have 
several small holes in them for connecting to pushrodsand other linkages. By connecting your linkage 
far titer away from the center of the shaft, you Increase the throw as the shaft rotates but decrease the 
force behind it. Similarly, a placement closer to the center of the shaft produces a shorter throw with 
much more persuasion. 

Hobby servos are excellent choices for robotic arm and haod applications, due to their small size, 
tremendous torque, and simple Interface. If you already have a model car. boat, or airplane that uses 
hobby servos, you can use the radio transmitter and receiver for quick tests of motion. 

Most hohby servos can be modified to remove the bard-stop and permit continuous rotation. The 
procedure varies from one model to another, hut the basic steps are as follows: 

t „ Carefu iiy o p en i h e servo h od y by re otovi n g t he fo u r screws fro m the back . 

2. Remove the final output gear, which is often molded to the output shaft. 

3, Cut or file off the stop tabs (don't get any particles in the gear's teeth). 

4. Drill out the center of the output shaft that engages the position-sensing 
potentiometer. 

5, Center the shaft of the potentiometer (If power Is applied to the servo, adjust 
the pol until the motor stops spinning). 

6, Reassemble the gear train, without disturbing the position of the 
potentiometer. 

7. Close the servo body by replacing the cover and tightening the screws. 

The centering of the position -sensing potentiometer is critical in tills process. Some guides suggest 
removing the potentiometer completely and replacing it with a pair of matching, fixed -value resistors, to 
simulate the centered pot without Lhe possibility of it accidenially getting readjusted. 

The setting of tit is internal pot determines the null or center position of the servo In Its new role as a 
continuous rotation gear- motor. A modified servo behaves in a number of different ways to varying 
control inputs when compared to a non modi fled servo. First, and perhaps most important, it should 
now have the mechanical freedom in rotate continuously in either direction. Second, because the 
position sensor is no longer directly connected to the output shaft, the motor responds differently to the 
input pulses. 

Instead of seeking a leftward position, the motor spins lo the left Indefinitely. This is because the 
error term — tbai Is. the difference between the desired position and the actual position— Isn't 
decreasing over time. The same Is true for rightward motion, with the motor endlessly spinning to the 
right and never seeming to be able to catch up. 
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If the now-detached potentiometer is properly and exactly centered, tiien when a pulse of exactly 
1.5ms duration is received, the motor will stop. This is the only time the Inner control system feels that it 
has done its jolt properly. That is why Lite adjustment of this pot, even though mechanically isolated 
from the remainder of the mechanism, still plays an important part in the operation of the servo. 

Some servo layouts permit an access hole to he drilled in the ease of the servo so the potentiometer 
can he adjusted evert when the servo is fully assembled, lit some cases, the potentiometer shaft can lie 
accessed via the center hole in the output shaft when the servo horn is removed. There’s no reason you 
can’t physically remove the potentiometer front the unit entirely, extending the wires front it back to the 
control hoard, and mount the pot anywhere that is convenient for you. 

Because the servo's null point varies by a few (or maybe several) microseconds overvoltage and 
temperature, there’s not a Lot of value in going overboard with the hardware side of things, because you 
can make the same adjustment just as easily in software (adjusting the pulse width to match the 
hardware, instead of the other way around}, with the exception of really severe misalignments. 

Modified servos make excellent digitally controlled motors for small, wheeled robots. You get a DC 
motor with gear-reduction, a standardized package, and shaft and control electronics all In a single 
compact and lightweight device. 


Solenoids 

The simplest variation of an electromagnetic motion transducer La a solenoid, it converts electric current 
into linear or rotary motion, depending on the solenoid's configuration. It’s basically a coil of wire (the 
efectrojMiigMer) and a metal slug or plunger, which is tech ideally the armature. When the coil is 
energized, a magnetic field surrounds the solenoid, and the plunger is drawn into it. 

Plungers can either he free or captive. There may or may not he a bottom to the solenoid. If not, it’s 
open at both ends. 

The linear motion of a solenoid is quite nonlinear in behavior. Close to the bottom of the stroke of a 
closed, linear solenoLd. the force exerted on the plunger is enormous. As it moves farther away from the 
body of Lhe solenoid, the force diminishes rapidly. 

Solenoids are usually specified fora certain effective stroke length. They also have a maximum 
current capacity (rated in amps or mllliamps) and a characteristic impedance (in ohms). 


Sensors 

Your robot can have as many or more senses titan you have, or it can wear blinders and focus entirely on 
a small trickle of data front a rudimentary sensorium. The ultimate deciding factor lies in your 
expectations for each of the robot projects that you design. 


Light Sensors 

If you look at insects closely, they have fascinating, multifaceted compound eyes. The world must look 
interesting to them! 

But took a little more closely, and you also see some simpler yes, which resemble little black dots. 
OK, now back up a little; you're making that bug nervous. The difference between simple and compound 
eyes lies In the number of lenses involved, and not in the inner complexity of the underlying 
photoreceptors a nd neural systems. Because the simple eyes of insects lack a ntore sophisticated lens 
system than human eyes, they aren’t able to resolve images. They are, however, quite good at 
determining light levels and due to their more streamlined connections directly into insect brains, are 
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considered faster than compound eyes at detecting motion. The celebrated compound eye of the Insect 
is much more effective at more complex tasks such as edge-detection. 

The human eye, no matter hoi* much more complex than Spidey's seventh or eighth eye. is still 
considered a simple eye. Don’t let the word simple fool you! 

So you want to give your robot some eyes? It's very easy. You cast even use an LED as a low- 
resolution light sensor. It's low resolution in the sense that it doesn't resolve images like ihe Insect's 
simple eye, as well ashy the fact that It only gives a rough idea of the ambient lighting levels. It’s not hard 
to add a simple transistor amplifier circuit to the LED -a s-light- sensor to give It a much larger range of 
readings. 

A single light sensor such as this one can report on the ambient Light levels Jn a room, perhaps 
turning on a nigh Might when the sun goes down. Beware of the endless loop this can create! Light level 
goes down, S.ED conies on, Increasing the light level, which turns off the LED ... you get the idea. 

This type of oscillation Is certainty unwanted and can result any time some sort of amplification is 
used in the feedback loop. You can add hysteresis to the circuit, either in hardware or in software, to 
compensate for the affected readings. This means moving the trigger point taper down after you've done 
something that's going to propagate back to the beginning of your feedback loop. 

You can use the different values reported by two light sensors to determine the direction of the light. 
This allows you to play folio w-the-leader with a flashlight. 

Another vision application Is line-following. A robot that can follow a line on the ground sounds 
easy to buitd hut has some interesting design challenges. An array of infrared emitters and detectors Is 
used to sec the line on the ground. The robot can change its heading based on the relative position of the 
line. There are several clever algorithms for successfully fallowing a line, and you look at a couple of 
them shortly. 

A derivative of the line-following sensor is the cliff sensor, which can let your robot know when the 
floor ends and that first teally big step begins. 

Photosensitive resistors, also known by many other names, such as pflofo cells , light-dependent 
resistors, and CdS (cadmium sulfide) cells, act like a variable resistor, exhibiting high resistance In the 
dark but lower resistance when exposed to light. CdS cells, specifically, were once quite common in 
anything that needed to react 10 changes In lighting, such as street tight controllers, alarm clocks, 
automatic nigh flights, and so on. Because cadmium is a toxic substance, other materials are being used 
these days in their manufacture. 

Phototransistors and photodiodes can also give your robot an Idea of what the world looks tike. 
Typical photo transistors and photodiodes, however, are usually optimized for use in the near-infrared 
region of the spectrum. This is handy when you want to detect Infrared Eight, but not so good otherwise. 

An array of light sensors, even a small one, can give your robot the ability to resolve very simple 
images. Coupled with some clever programming, you can then detect motion and edges. 

You can even add a color video camera with object- tracking capabilities. This is possible if you can 
find or build an AVRcam, an open source alternative to the CMlJcam. L’hese unlis are from way back In. 
2f)04t they used a couple of AVRs to read the output from a digital VGA camera module and had the 
ahility to track objects of a defined color. Even though the AVRcam is no longer available for sale, you 
can still download the schematic and source code from the creator's website: 
wuw.j robot, net j'D&wn load. ht*l. isn’t open source great? 


Touch Sensors 

Technically referred to as tactile sensor s, touch sensors are anything that reports a physical touch to the 
robot. This can be as simple as a micro switch or two built Into a bumper or as complex as a capacitive 
touchpad for user input. At me! publishes a set of functions for its AVR products That implement .several 
kinds of touch sensors, including button, sliders, and wheels, called the QTnucb library. See the Atmel 
website fww w. atmel . coni) for more information. 
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Several models of micro switches have extended levers attached to die body of the switch, and some 
even have rollers on the end of the Levers. These are often attached to panels on electronic modules to 
deactivate high -voltage circuits when a user opens an access panel. They have many other uses r of 
course, and you can use them as bumper switches on your robots. They look like blunt antennae and 
serve a similar purpose. 

If you place two switches. Left and right, past the from edge of your robot, you can tell If your rohot 
humps Into an obstacle (not every obstacle, but It's a start); plus you can determine If it hit something on 
the left, the right, or spang in Lhe middle, if both switches are activated at the same time. This can give 
your robot a clue as to what to do next. If you're intending Jt to avoid obstacles, you can stop, hack up, 
and turn in the appropriate direction, if, Instead, you wish your robot to engage obstacles, Elkea 
bulldozer, you have a good idea of what to do then, as well. 

By pointing the levers of the switches down ward, you can implement a different kind of cliff sensor. 
Just he careful not to orient them in such as way such that the levers form barbs, preventing your robot 
from backing away from the edge. 


Noncontact Sensors 

Although I earlier spoke of line- following sensors as vision sensors, you can also use a very similar 
circuit, hut with a slightly different hardware orientation, to act as a proximity sensor (see Chapter l(l for 
a basic version of the I R proximity sensor). This type of proximity sensor depends on the reflectivity of 
the obstacle In lhe near Infrared (IR) band. 

A more sophisticated approach Is to use software 10 measure the IR detector reading with the ER 
emitters on and then again with them off. The difference is then used to determine If an obstacle is 
reflecting the emitted light or if the sen sot is picking up am hie n i Lnirarcd in the vicinity. 

An even more sophisticated and often more reliable approach is employed when modulated ER Eight 
is emitted and a tuned receiver is used as a detector. This is Identical to the IR remote-control example 
project in Chapter fl. The only difference is that the signal output by the IR LED is a modulated carrier 
wave and contains no re mote -control codes. 

It's difficult to extract precise measurement information from the IR proximity detector, however. 
There are too many uncontrolled factors governing die amount of Infrared light that Is reflected back to 
the sensor. 

Another solution is to use sonar. The speed of sound in air is known and depends on temperature 
and air pressure. You can emit a coded hurst of sound and measure the amount of time It takes to make 
a round trip. Half of this time is the time it took the sound waves to strike the first obstacle and return. 
There are almost always secondary obstacles, whose sonar profile returns later. More complex sonar 
devices report not only the closest obstacle, hut also a number of subsequent echoes. 

Simple sonar modules are now quite inexpensive, compact, and reliable. Their radiated sound cone 
is tailored for several different applications, so you can pick the one that is right for your rohot. 

The simplest method for Interfacing with a sonar module to is to trigger a ping and measure the 
time it takes for the echo signal to arrive. Using the ti me r/ counter peripheral on the AVR, you can 
measure distances with very good accuracy and high resolution. 

Many sonar modules have a dead spot Immediately in front of their transducers, preventing them 
from measuring the distance to targets that are very close. One solution is to mount the sonar module at 
the rear of the rohot and pointing forward, where it won't accidentally pick up echoes from part of the 
robot body. 

However, if you already know the distance to a particular part of the rohot, and either tbe sonar 
module or an articulated member can he correctly aligned, then you can measure the temperature or air 
density, depending on which one Is less likely to remain stable. 

Laser range-finders are generally much more sophisticated sensors, with the associated price tag. 
But bargains pop up from time to time, especially in the electronic surplus markets. These sensors can 
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scan an entire room in a fraction of a second and give accurate measurements to each reflective point 
within millimeters. They do tend, however, to be quite large, heavy, and power-hungry, when compared 
with other available sensors. 

A laser range-finder typically uses an IR laser and a spinning mirror to distribute the modulated 
laser beam. A high-speed sensor is used to measure any returning reflections, and an on -hoard 
computer calculates the range and angle. 


Audio Sensors 

Measuring sound tends to he tricky using an Arduino because of the short durations of most sounds. A 
microphone with the proper p ^amplification circuit can easily be attached in an analog- to -digital 
converter (ADC} input, but the Arduino either needs to he listening ai exut'tfy the right time or it needs to 
be continuously sampling the Incoming audio ai a very high rate as well as constantly analyzing the 
incoming data for patterns of interest. 

Self-contained speech- recognition modules are becoming more affordable and robust. The simplest 
type of speech recognition is termed speaker* (iep?7hient and must be trained by the intended speaker. 
Tills training is performed by repeatedly saying predetermined phrases into a microphone. The module 
then analyzes Lhese samples and calculates an average profile that it uses to match incoming voice 
commands. 

Responding to single-word commands Ls one thing; con iln a ems speech recognition is quite another. 
Be prepared to speak slowly, dearly, and paitenilyta your robot. Involuntary stress reactions may alter 
your voice characteristics enough to push them outside the acceptable recognition parameters. Veiling 
doesn’t help. 

Speaker-independent voice recognition is much more complex, because it must account for natural 
variations In pitch and intonation from various speakers. 

[f you're willing to put the power of your PC into the loop, there are many free as well as low -cost 
speech- recognition programs available that can effectively utilize those larger computing resources. 


Indicators, Controls, and Other Forms of Communication 

Your robot needs blinking tights (.so many Eights! and possibly the occasional beep or chirp. The Eights 
arc mesmerizing, but tire noises are annoying after a while. 

[[ere area few suggestions for making the ideal, well-behaved robot. Don't assume that other 
people are going to intuitively know howto operate your robot. It's up to you to make it safe and robust 
People like to interact with robots, so try to make it an entertaining experience. For example, don't put 
the Initiate Dance Sequence button right next to the Deploy Bee Cannon button. 

Your rohot certainly needs some visual indicators to let you know what's going on at a glance. Some 
number of controls also need to he available, which, in conjunction with the indicators, form the local 
user Interface. A remote user interface can also be Implemented. 

If your robot uses any form of stored energy, such as batteries, for safety reasons it's necessary to 
implement a qnlek-dlsconnecl for Local power. This is sometimes called a kill switch and should be 
readily accessible and prominently marked. 

For a robot that can scoot faster than you, the switch can be implemented using a tether or lanyard. 
When Installed, the robot operates normally, hut when pulled or completely detached, the robot shuts 
down. This type of mechanism is sometimes used on personal watercraft, where the lanyard ls attached 
to the user’s life jacket. If the user for some reason leaves the vicinity of the vehicle, the motor is 
automatically killed, preventing it from getting too far away. 

The rohot should also have a primary power switch for normal usage. This switch should Ire 
prominently labeled, in the immediate vicinity of this power switch should be some sort of visual 
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indicator , such as a greet] or blue LED. Save the red r orange, and possibly yellow LEDs for warning 
indicators. 

Beyond these basic tenets, the design of your local user interface Is governed by the robot's 
intended function. Is it a multipurpose robot, able to address a wide array of tasks? it might need a fairly 
complex user Interface, Involving one or more graphic displays and user Inputs. Does it have a single 
purpose? Then it should have specialized controls precisely adapted to Its function. 

Buttons are good. People like to press buttons. Mount your robot's buttons so they’re easily 
accessible when the robot is lit its normal environment. .Match ibe button’s tactile force [the amount of 
force necessary to activate the button) with Lite size and shape of your robot. Don’t use a button that’s so 
stiff that pushing the button slides the robot away from you. 

If possible, place some sort of label afwuethe button, so the function of the button Isn't obscured by 
Lbe pressing finger. It's also nice to have visual, audible, or tactile feedback that the button- press has 
been received by the robot’s control system. 

Toggle switches are also good as long as they're properly labeled. Don't make people guess which 
way Is "on." Again, some sort of additional feedback to indicate that the robot has noticed the change in 
the state of a toggle: switch is always welcome. 

Dials and knobs are also very useful hut can be problematic on a mobile robot. Vibration and 
accidental contact with obstacles can upset a carefully adjusted setting In no time. 

Would your robot benefit from having its own voice? Beeps and blips are all within the traditional 
robot milieu, bui a synthesized (or recorded) human voice Is handy in certain circumstances. Digitized 
sound samples tend to take up a Lot of room, storage- wise, but this becomes a non -problem with the 
addition of an SD card interface to your Arduino lyes, there's a shield for that). Self-contained speech 
synthesizers are even less expensive than speech -recognition modules these days. Again, if you want to 
include your PC In the robot-control loop, text-to-speech 1TTS) software Is freely available. 

Exactly how autonomous do you want your robot to be, anyway? If you envision a completely self- 
contained system that automatically performs Its Intended function with no interaction wltEi you, then 
the user- Interface part of the design process cao be very straightforward. If you want to Interact with 
your robot oo a regular or even frequent basis, a more complex and well-thought-out user Interface Is 
required. There's no problem if this takes a while and must be adapted over several iterations. 

Even If you don't envision spending a lot of time chatting with your robot, its always a good idea to 
implement some sort of com mand-and- control protocol. This cao be as simple as a text menu system 
over a serial port or as complex as you want to Imagine. You need to be able to query the robot as to Its 
present status, possibly including battery level, present location, or any other runtime variables you may 
need to know. You also need to be able to alter or direct the robot's behavior as you see fit. Again, these 
design decisions are driven directly by your goals and aspirations for a particular robot. 

This command -and -control protocol should he Implemented using whatever robust 
communication channels arc available to your robot. Do you want to tether the robot to your PC’ with a 
USB cable? That's great for starting out, as you try later in this chapter. Mow about a wireless link? This 
can be a radio connection of many different types or a modulated IR remote control. Bear In inLnd that 
ideally you have two-way communication with your robot. A backup plan is good to have, as well. 


Control Systems 

An entire subfleld of mathematics and engineering is devoted to the subject of control theory. The 
central Idea is that a system, which has a measurable output and a controlling Input, can be stabilized 
with the use of negative feedback. 

You can use an Arduino to perform several of these functions for you In a robot. You already know 
that the Arduino Is good at doing simple things quite rapidly. It can measure voltages, count accurately. 


316 


CHAPTER 13 MORE EXAMPLE PROJECTS 


and control external circuitry with the appropriate driver circuits. These abilities make It especially well 
qualified to use as a starting point in building a robot -controller circuit. 


Open-Loop Systems 

When you blink an LED using an Ardulno, you verify 1 the output with your eyes and then make any 
needed adjustments to your sketch until you get the correct behavior. This is an example of two different 
control loops in action: both open and closed loops. Let’s look at each one in turn. 

The Ardulno and its associated LED form an open- loop system. The ArduLno raises the voltage on an 
DO pin and then makes several, possibly faulty, assumptions. The first assumption is that there Is an 
LED properly wired with the correct polarity to tins particular pin. The second Is that the LED then turns 
on. The Ardulno takes no steps to verify success or to correct any problems. 

Vet the LED still blinks. It's not hard to connect an LED to an Arduino; but there were enough bad 
possible combinations present In the solution space that the Arduino Team wisely decided to go ahead 
and plumb one directly on the hoard, eliminating any possibility of failure at this introductory level. That 
was an unquestionably good decision on their part. People like to experience positive results early in a 
new adventure. 

Now the Ardulno can Issue a command to the LED, and Lite LED will comply. There is no need for 
any sort of confirmation. This is an open-loop system because there is no feedback loop connecting the 
output of the system with the controller that is In charge of the input. 

In many situations, no feedback is necessary for proper operation. You don't need to at tacit a 
microphone to every speaker to verify that beeps arc being emitted. You can assume they're being 
emitted and continue. Likewise, hobby servos can be directed to align with an indicated angle by 
sending a variable -width pulse, without having to measure the rotation and ad just the input signal. This 
is because the servo Is implementing itsoum closed -loop feedback system, comparing the output shaft 
angle with the requested input and making changes accordingly. From the Arduino s perspective, the 
servo motor just works. 

When you add yourself to the loop, you provide the necessary feedback to ensure success by using 
your high-level detectors to validate proper behavior. When you detect error, you then take measures to 
correct the error. In the ease of hlinklng the LED, you first check that the LED is attached in the 
necessary configuration and then verify that it isn't on fire. 


Note If it’s not on fire, Et’s a software problem. 


Once you’ve ruled out hardware problems, you look to the software involved. Did you get the DO 
port's direction bit correctly using the piiiMode[) function? Are you addressing the right pin number? Are 
the delays long enough to prevent the blinking from blurring into, um. weli ... non-blinking? 

You try this and then you try chat, and eventually you get the LED blinking, in this example, the 
programmer forms the feedback loop, adjusting the input parameters until the error is zeroed out — that 
is, the output corresponds with your expectations. 


Closed-Loop Systems 

When the system being controlled gets more complicated than a single LED or simple actuator, you 
should start looking at closed-loop control systems. This requires a feedback path that can measure the 
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output and compare it to the desired reference, or set point. The difference in these two quantities Is the 
error term. The error term Is used to adjust the Input that controls the system, and the loop repeats. 

Sometimes a closed loop system can be very simple. If a robot needs to go from Point A to Point B, 
assuming it can keep up with its own position, then the only question it has to ask is, "Am I there yet?" it 
does this by comparing its present position with Lis target position, which is Point ii. If the distance from 
the target is Increasing, the robot m ust turn around. If the distance Is decreasing, the robot must 
continue until the distance (the error! is zero. At this point, it needs to stop, as far as achieving Us goal of 
arriving at Point B. 

Other examples of simple closed-loop systems are heating elements. Suppose you want to raise tire 
temperature of a process oven to a particular temperature and then keep it there fora specified period of 
time. A temperature probe provides the present temperature in the oven, and some sort of adjustable 
heater control is manipulated by the controller. This control can he as simple as an on/off switch. If the 
temperature Is too low, turn on the heater. If the temperature is too high, turn off the heater. Assuming 
the heater element Ls capable of achieving the desired temperature, the closed-loop controller will 
ensure that it gets to the right temperature and stays there. 

Now here Is where it starts to get Interesting. Heater applications area really good example because 
they’re never as simple to control as It would seem. First, the heater element doesn’t go up to infinity 
instantly. It takes a certain amount of time. This varies with the element's present temperature, the 
temperature of the ambient air, and the amount of current that can be supplied to the heater (assuming 
it's an electric heater), among other things. All these factors affect how quickly the temperature rises. 
Also, the time it takes for the oven to cool off enough to trigger the beater again varies according to Its 
own unique set of parameters. 

These factors contribute to fag In the system. An adjustment to the Input is made, hut the output 
hasn't quite gotten there ... yet. Also, the actual temperature in the oven and Lite reading reported by the 
thermometer may not be exactly In synchronization either. In most practical applications, many more 
factors affect the system’s response time. 

Several problems can result from too much lag In the control Loop. One Ls overshoot, where the 
system output continues to rise even after the control Input has been adjusted downward. This is very 
common in thermal-management systems, because heat Lakes Us sweet time spreading through some 
materials yet flows like water through others. The corresponding symptom of undershoot Ls equally 
problematic. 

Both overshoot and undershoot can be mitigated by having more subtle adjustment capabilities 
than on and off. If you can reduce the amount of correction to the Input as the error approaches zero, a 
very smooth transition can take place from the warming-up stage to Lhc maintaining- temperature stage. 

This is called proportional control where the input control Is slewed at a rate proportional to the 
error, hr the case of a targe error, a great deal of input Is requested. If only a Little error exists, then only a 
nudge is made to the control Input. This error is also called the present or Instantaneous error term. 

Because the application of proportional control usually involves an amplification of the error signal, 
the possibility of oscillation exists. This behavior either can result in hunting back and forth near the 
reference point, without actually achieving equilibrium, or in worse cases can cause damaging full-scale 
swings, slamming the control Input from the top of Its range to the bottom repeatedly. This second 
scenario is exactly what happens when a microphone gets too close to a public-address speaker, and 
ear-splitting feedback takes over the system. 

The error is typically not fed directly hack into the control input, because it mayor may not directly 
correspond with the sensitivity of the control input. Instead, a fraction (or multiple) of the error is 
combined hack to the input. This proportional factor mu si be tuned for each system. Too large a factor 
produces instability and the possibility of oscillation. Too small a factor Increases the response time, 
causing Lt to only slowly adjust to changes in the desired Input. Typically you start with a factor of 1,0 
and see how it goes. The proportional term generally contributes the most to the total correction, and 
you can calculate a couple of other error terms that will also be of value. 
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Adding up -Ei I L the error terms over time gives, you the Integra terror term. Ideally. the errors should 
eventually all cancel out r returning this value to near zero over time. By adding this term to the 
proportional term, the controller input can more accurately correct for drift (at steady-state error), which 
can happen when a large change Is made to the desired set point. The integral term should also have its 
own factor, which. Eike the proportional factor, must he tuned for each application. The integral factor, 
however, Is often much smaller than the proportional factor, because it should only contribute 
additional correction when the error has been significant over a period of time and the proportional 
correction just isn’t getting the Job done quickly enough. 

The possibility exists, on the other hand, that the integral error term quickly spirals out of control, 
because the system hasn't come hack Into compliance soon enough. Because It’s a cumulative record of 
all errors ever, it can take some time for It to get back to a usahie value, yet still be skewing the control 
input in the process. Applying an integral windup limit can help prevent this from happening. 

You can make one further adjustment 10 the control loop to predict the future and help smooth out 
any humps. The rate of change in the error term, or derivative* is a good predictor of where the error is 
headed. This can be elaborately defined using calculus, or it can be approximated by subtracting the 
previous error term calculated from the present term. 

The derivative error term helps reduce the rate of change of the control input, helping to slow things 
down and smooth tilings out. This helps to reduce overshoot and undershoot when the set point 
changes. It can also have the undesired effect of reducing the system's sensitivity to change and overall 
responsiveness. Like the Integral factor, the derivative factor is usually quite small when compared to the 
proportional factor. 

These three calculated error terms are usually abbreviated P, 1, and D. You often see references to 
RID filters and R3D control loops when reading about speed controls and other automation topics. The 
associated factors for each of the terms are generally referred to as K r , K , and K h . 

Using just the proportional term is often sufficient to get good closed-loop control of a system. 
Sometimes only the P and I terms are needed, aod this is called a PI controller. If only the P and D terms 
are used, It’s a PD controller. 


Example Robot Projects 

1 1 ere are some really simple robots that you can build using an Arduino and a minimum of other parts. 
They aren’t especially good at anything, except perhaps helping you learn how things work inside a 
robot. 

You start with a simple group of projects based around a mobile robot that never seems to get 
anywhere. Then you move on to a mobile robot that has a good but not infallible idea of where it is. 
Finally, you start to think about what you would like to have In your ultimate robot. What will ihat be? 

Each robot project is a collection of smaller subprojects, it won’t do you much good ro skip ahead 
here, because each project builds on the results of the previous ones. Remember, the robot as a whole 
succeeds or fails based on the collective cooperation of its constituent components. 

Although most robotics tutorials give interesting or at least descriptive names to their project robots 
(usually ending in baft, that particular aspect of creativity is left as an exercise for you. 


A Practice Robot 

Let's start with a very simple robot that you can use to practice your budding robotics techniques. You 
huild an Arduino- compatible circuit (Duemilanove class, to he exact! on a solderless breadboard, then 
attach a pair of servo motors with plastic wheels mounted to them. Next you add a pair of 
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potentiometers to lie able to adjust parameters lit real time, and finally you add a pair of bumper 
switches to the front of the robot. 

There is a lor of latitude left In the oxaet execution of Lids robot. You're free to place the components 
anywhere you see fit, or where you find them to be most convenient. Using a standard 030-tle-polnt 
breadboard, plenty of room Ls leftover for more experimental circuitry. Feel free lo improvise. See 
Figure 13-1. 



Figure 13-1. Aw Anikina robot bull! on a solderless breadboard 


The Control Circuit 

The basic construction of the Ardui.no circuit ls very straightforward. An ATmega32Schlp. 
preprogrammed tvltb the Arduino bootloader and bearing a handy pin label, Is the heart of the circuit. 
Power and ground connections are made on both sides of the chip, and a IOjiF capacitor is placed at 
each location to help minimize the effects of power surges. In fact, anywhere In the circuit where power 
enters or leaves, a 10pF capacitor Is placed across the power lines. The circuit uses a ItiMMz quartz 
crystal as the system clock. The main processor section of the circuit also contains a reset pushbutton 
(just in case? and a power-on LBD indicator. 

Two potentiometers are placed back-to-back on the breadboard and con figured as voltage dividers 
between V > and GMD. The wiper contacts, being now a user-variable voltage between Q-SV, are 
connected io analog inputs AO and Al. 

Two three-pin headers arc Installed in the breadboard to form connectors for the two servo motors 
that will be used as drive motors. These connectors are connected to V.. and GND, and each has its own 
10|iF capacitor to help supply sudden current demands otade by the motors. 

The motor-control signals a re connected to digital pins D9 and DID for the left and right wheel 
motors, respectively. Not coincidentally, these pins correspond to AVR I/O pins PBl and PB2, which also 
serve as PVVM output pins for Timer/Counter i, OC l A, and OC1 B. 
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The Wheel Motors 

The motors ire mounted to the bottom of the breadboard, using the double-sided foam tape provided 
with the breadboards. Only a small portion of the protective backing Is removed, just the size nf the side 
of the servo motors. See Figure 13-2. 



Figure 13-2. Mount the servo motors to the bottom of the breadboard using double- sided fount tape. 

The servo motors are 10-gram analog micro servos from Hobby King (*,<.«. hobby king.ccwt), part 
number UK 15178. They're cheap and easy to modify for continuous rotation, assuming you've got the 
tiny screwdriver needed to take out those tiny screws. Once you're inside, it's not hard to make the 
alteration. 

Use the supplied servo horns to mount a plastic disc to be used as a wheel. The screws that are 
provided for mounting the servos to a frame are repurposed for mounting the horn to the wheels. Note 
the center hole in the wheel, which allows you to remove the horn and wheel as an assembly from the 
servo without having to remove the wheel from the horn. 

Larger servos can certainty be used. Feel free to substitute parts as you find them available. The nice 
thing about really small servos is that they don’t draw m uch current. Just don't try stalling them, because 
then they redraw that much current, and maybe a Little more. 

The wheels aren’t very good. That, believe it or not, is by design. This robot isn't really supposed to 
go anywhere. You want the wheels to spin, hut you don’t want the robot to run off the edge of the desk. 
You can also put the robot on a Little stand or. better yet, mount a collapsible kickstand near the back 
wheels. Save that fora later project — you stilt need io get the wheels spinning before you consider 
solutions to unintended consequences. 
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And The Rest 

The bumper switches on the front of the robot are mounted in a similar manner, using the double- sided 
foam tape on the underside of the breadboard. 

For power, at Least during the very initial stages of bringing this robot to Life, you use tire regulated 
+5V provided by the USB interface. 


Drive Configurations 

Note the configuration of the servos. They're mounted as mirror Images of each ocher. This allows the 
output shafts to emerge from opposite sides of the robot carapace without requiring any extra gears or 
linkages. This drive arrangement Is often referred to as differential steering* which Isn't exactly the same 
thing as the differential drive commonly used in an automobile, although they share some common 
principles. Think of it more in the way you can navigate while silting in a wheelchair. 

If both wheels roll In the same direction and a i the same speed, the robot goes either forward or 
backward In a straight line. If one wheel travels in the opposite direction of the other, hut they still rotate 
at the same speed, then the robot turns in place, pivoting about a center point. By varying the velocity of 
the wheels with respect to each other, any straight or curved path can be travelled, and at any point 
along the way the robot can stop and swivel into any other heading and continue travelling. That’s a lot 
of flexibility in what could possibly be the simplest mechanical arrangement. 

There are many more possible configurations for wheeled robots. Each has Its own relative merits, 
although some are much more complicated than your practice robot's system and others are exceedingly 
more complicated. The choice is yours. 


Motor Math 

You knew Li was coming. 

First you need to exert some control over the speed and direction of each wheel independently. 
Technically, speed combined with a direction is i*elocity. The direction can be up or down, right or left, 
clockwise or counterclockwise, or even positive or negative. 

If you're having a hard time understanding the difference, perhaps They Might Be Giants can help. 
See their entertaining and instructional video on YouTube: wv* .youtube „ com/watch?v-[?fibsPSxJerh. 

When you speak of the rotation of a motor, the convention is to refer to the apparent motion when 
viewing the motor's face, with the shaft emerging from its face and pointing at yours. Lei's sLa« spinning 
those motors already. 

To begin, let's check how closely your servos are calibrated by sending a precise 15ms pulse to each 
of the motors and seeing If they spin. Alternately, you can use this sketch as a timing reference for 
calibrating your servos, if you're still In the process. See Listing 13-1. 

Listing 13-1. Creating Precise 1. Sms Pulses to Calibrate or Verify Modified Sernas 
flint Lade clervo.h> 

Servo leftServo, rightServo; 


322 


CHAPTER 13 MORE EXAMPLE PROJECTS 


void setupO { 

LeftServo.attach{9); // D-9 is connected to the left servo 
jightServo.att:ach(iO); // Did Is connected to the r ight servo 
Lef tSer vo. write, Hi croseconds( 1500); // centering pulse 
rightServo.wrlteHicrosecQnds(i500) j; // centering pulse 

} 

void loopO { 

} 


You include [he header file for the Arduino-supplied Servo library, Servo .h. This gives you access to 
some convenient functions for working with servo motors, both standard and modified. 

In tlris ease r everything is performed in the sketch's set upQ function. The LoopO function is empty 
tint required. A pair of Servo objects Is instantiated in the global scope [that Ls. outside of any function),, 
named leftServa and right Servo. In the setup () function, you attach them to the PWM output pins with 
the Servo. attach () method. 

The Servo library's write () method takes a parameter expressed in degrees and converts that Into 
the appropriate number of microseconds for the PWM outputs. You want to bypass that and express 
your desired setting In microseconds, and the Servo library accommodates Lhat with the 
Servo, writeMicrosccondsO method. You set both tire left and rigid servo objects to 1,500 microseconds, 
which should cause the wheels to he energized (that is, you shouldn't he able to turn them, or at least 
should feel a good hit of resistance) bui nor moving. If they are moving (and they most probably are), 
then you have an excellent opportunity to calibrate them to what your Arduino thinks is a 1.5ms 
centering pulse. Remember, this calibration ls done by adjusting the Internal position-sensing pot of the 
servo, which should no longer be mechanically attached to tire output shaft. 

Asa side note, it realty doesn't matter that much how accurate your Arduino's clock is at this point, 
as tong as you can calibrate everything according to its standard. The real problems come into play when 
the voltage and temperature begin to drift, because these are the chief components of clock error. 

Oft. so the first fact of motor math is that 1,500 microseconds Is supposed to he the middle of the 
range, at which point the wheel Is spinning neither clockwise nor counterclockwise. Clot it? It comes up a 
lot when dealing with servo motors, sn you might was well understand it instead of blindly accepting it 
and committing It to memory. 

Next up are tire endpoints to this range. They're easy enough to remember: 1.0ms and 2.0ms. But 
which one spins which way? Let’s find out. See Listing 12-2. 

Lifting 13-2. Experimenting with Servo Direction and Speed 
Sinclude <Servo.h> 

Servo leftScrvo, rightServo; 
void setupO { 

LeftServo. attach^); ii pin D9 is connected to the Left servo 
lightServo.attach(lQ); // pin DIO is connected to the right servo 

} 

void loop() 1 

int leftAdjust, right Ad Justj 
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Left Ad jin it - analogfceadi(o) ; // read left servo adjust 
rigbtAdjiust = analcgtead(l) ; U read right servo adjust 

Lef tier vo. writ e,Hierosoconds( left Ad just 4 1500 * 512); 
right Servo* writeMicrosec&nds( right Ad just ♦ 1500 - 5i2); 

deLayfzo); 

} 

Again you include the iervo.h header tile because you’re still using the Servo library. The same 
left Servo and right Servo objects are Instantiated and then attached to the correct PVVM output pins In 
the sc tup 0 function using the Servo .attach ( ) method. 

The real fun begins in the loupQ function, which actually has something En it this time. Two 
adjustment variables, left Ad just and right Ad just, are declared as signed integers (remember, all scalar 
variables in C are signed values unless ynu specifically Indicate they aren't with the unsigned qualifier — 
except for char, which Ls implementation dependent for some reason). You want these values to be 
signed because they may or may not stay within the realm of positive numbers. In ibis example sketch 
they do, hut you may find other uses for them soon enough. 

The two potentiometers are read using the analogReadO function, and tire results are stored Ln the 
left Ad just and rightAdjust variables. If you recall, tire results from these analog-to-dlgital conversions 
will he it] the range of 0 to 1,023, with 0 representing voltages closer to ground and the high end of [he 
scale corresponding [o a voltage ai or near V . . Because tire potentiometers are wired up as voltage 
dividers across V and ground, they should provide a full range of these values as you ad just the dials. 

Now a little tricky math comes Into play. You really want the two adjustment values to be positive or 
negative offsets, centered about ic-ro. You could subtract 512 from both values, which would shift 
(technically, muishne) their values from 0-1,023 to a more balanced range of -512 to 4-51 1, giving you a 
lot of latitude In both directions, so to speak, But let's wait a second, because you're about to do add 
another constant value into the mix: and by doing all of them at once In the same formula, the camp tier 
can do most of site math for you, saving calculation time and program memory for your little Ardulno. 

You have a good range of adjustment values, in theory, because if you consider these leftAdjust 
and rightAdjust values to he numbers that represent microseconds, you cast use them, with a suita hie 
offset, as tire parameters for the 5ervo . writ cMicres ecu ndsf) method. Thai suitable offset happens to he 
1.5 All, the number of microseconds that constitutes a centering pulse for a modified servo. If you add 
1,500 to the adjustment values, you get a number that varies across a good range of numbers with 1,500 
right in tiie middle. 

I could have just said, "Now add to that number, and you're done," and it would have worked 
(and that's exactly whaL the compiler is going to do anyway), hut it snakes no sense. It's what Is known as 
a magic tt umber. It works, hut nobody knows how or why, You should avoid magic numbers at every 
opportunity. 


Caution Avoid magic num tiers and special cases. 


So now you look at the long train of numbers in the formula, and you can see numbers that you 
understand. The adjustment variable Is a number in the range of 0 to 1,022; ! ,500 Is the center of lite 
desired range; and 512 is the midpoint (half of the maximum] of the adjustment variables' range. Oh, it 
gets better. Much better. 
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When you run the sketch, you should be able to adjust the velocity of both motors Independently, 
You should even be able to get the motors to stop rotating completely. You may notice tluit alter some 
time, the motors start to creep slowly In one direction or the other. This Is the Inevitable null creep that 
beleaguers robots with modified servos until you implement some son of velocity feedback, which you 
do In the next section of this chapter. 

Now, back to the original question, which is, "Which way does the motor go?" It helps If you have (or 
have access to) an oscilloscope to view the actual pulse waveforms on a screen. You can still figure out 
this puzzle without the use of such gizmos If you walk through the steps methodically. 

If you've wired up tire potentiometers so that a clockwise turn increases. the voltage going to the 
Ardu inn's analog inputs, then you can assume (correctly) (hat the value of the adjustment variable 
correspondingly increases. TbLs. in turn, Inc reases the width of the pulse going to the servo. You should 
he able to observe that this causes a more co u titereiockwise spi n to the motor. Conversely, turning the 
adjustment down results In a more clockwise spin of the motor. 

To reiterate: the further away from the center (1,500 microseconds] and toward the lotver endpoint 
(1.004 microseconds), the more clockwise the spin of the motor will be, and vice versa. 

Also note that the speed of the motor can be finely adjusted when it's near the middle of the range, 
down to a very slow crawl. It would be really convenient If tills response was Linear across the entire 1,0- 
2.0ms range! 

Sadly, it's not. Some hobby servos have an extremely narrow range near the midpoint that allows 
any sort of speed control. Sometimes this band can be as narrow as 0.2ms, with pulse widths of 1.4ms 
and 1. tints producing full -tilt rotation In either direction. 

The IEK 151“fls used In (bis particular experiment show surprisingly good range under no-load 
conditions, not reaching their maximum speeds until approaching the endpoints. 

Now you know how to spin the motor full tilt In either direction with jto problems, but getting it to 
slop is iffy at best. There is another way that removes all doubt as to its effectiveness, and that's exactly 
what you need for as long as this remains an open- loop system. All you have to do is stop sending pulses. 

You would reasonably think (hat a call to Servo. writeMitjrosecontls( ) with a parameter of zero 
would work, hut it doesn't. The Servo library's method constrains the range of permissible value to 
various ranges depending on what version of the Servo library you're using, usually between 0 and either 
ISO orSilti degrees, depending. 

There is at] overloaded Servo.attach( ) method that not only permits you to specify the pin number, 
hut also lets you use an overriding minimum and maximum pulse width value. This also doesn't work 
properly, because the library fudges the actual values with a TRIM_DUkATI4N offset to account for 
interrupt latency. Several other layers of cleverness in this library will ultimately make il unsuitable for 
your uses, but for these first, simple steps, It's adequate. 

You (.Yiff stop the wheels with the ^ervo. dctach( ) method. It's a bit heavy-handed, because you have 
to re-atlach{) It later with the right pin number to get the motors to spin again. 

To be fair to the Servo library, most of the layers of complexity it has developed are to serve two 
important purposes. The first is to hide the math-terror of microseconds and pulse widths from new 
users, substituting settings In degrees instead, and the second is to help prevent Inadvertent settings 
beyond the mechanical limits of most commonly available hobby servos. You II soon he in a position to 
take the training wheels off your robot and craft your own servo functions. 


Forward, Reverse, and Stop 

You can now write some really simple control functions for your servos, if all you need is three speeds. 
Let's use (he bumper switches as your Local user interface for initial testing. The left bumper switch Is 
connected between digital pin D2 and ground, and the right bumper switch is connected between digital 
pin D3 and ground. If you enable the huilt-in pullup resistors on both of those pins, then the inputs 
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should In.- HIGH when tlie bumper switch Is not engaged and. LOW when the switch has. been activated. See 
Listing 13-3. 

Listing 13- J. Testing the Three Speeds of a Servo: Forward, Reverse, and Stop 
S include < Serve. h> 

Servo left Servo; 

void setupO { 

digitalftfitef^, HIGH); // enable pullup on left bumper switch 
digltalwrite(3j HIGH); // enable pullup un right bumper switch 

1 

void loop() { 

LeftServo 1 attach{'9); // left wheel 
if (digitalfcead{ 2 ) == LDvr} { 
leftServo.writeHicroseconds(lDDO); H clockwise 
} else if {digitaIRead(3 } == LOW} { 
leftServo. writcHicroscconds(2-ODO) ; (/ anti-clockwise 

> else { 

left S ervo . d et ac h ( ) ; / / stop 

> 

} 

This test uses only one servo motor, the left one. The setupQ function enables the built-in pullup 
resistors on the two digital pins, 02 and D3, which default to being inputs after a reset. 

You attachf) the servo to the PWM pin every Lime the loop( ) function is called, because you mayor 
may not need to detach 0 Li In order to stop the servo rotation. 

If the left bumper switch attached to digital pin D2 Is LOW, that means the left bumper switch is being 
pressed, so you start turning the left servo clockwise. Then you check digital pin D3 in a similar manner, 
except litre you Induce a counterclockwise turning. If neither switch is registering then the servo is 
disabled using the detach() method. 

Notice that If you press both switches at the same time, the wheel spins clockwise. Why is this? if you 
follow the logic in the sketch, you sec that if the first test succeeds [the left bumper switch is pressed}, 
then the remainder of the tests are skipped, an d they have no chance of acting on the rotation of the 
wheels. 

This behavior is acceptable It) your trivial test sketch, but give some consideration to the 
undesirable effects this could have in a real-world application. There are other ways to evaluate sensor 
inputs and take actions appropriate to them, and you cover a few of them briefly in the next section of 
this chapter. 

Let’s rewrite this sketch to factor out some of the common elements, placing them In specialized 
functions. Sec Listing 13-4. 
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Listing IS -4. lining Serna Smart Functions. ia Hide the Implementation Details of Spinning n Wheel 
I? include < Servo . h> 

Servo leftServo; 
void setup() { 

digit al'N'rite(2 f HIGH); // enable puliup 
digit alwrite(3j HIGH); // enable puliup 

} 

Sdcfine leftBumper() (digitalStead(2) -- L&n) 

Sdefinc rightBumperO (digitalfteadd) -= LOW) 

void left5crvoClockwfse(} { 
lef tSer vo . att a c h ( 9 ) ; 

leftS.ervo.write,Hicrosec ends (LOGO); // clockwise 

} 

void leftServoAntiCLockwise() { 
lef tier vo . att a c h { 9 ) ; 

lef tSer vo. wiite. y ,icrosec ends (2000); // anti- clockwise 

} 

void leftScrvoStopO { 

leftServo.detachQ; // stop 

1 

void loopt) { 

if (left Bumper 0) { 
leftServoClockwiseO ; 

} else if {rightBumperO) { 
leftServoAntiClockwise Q ; 

} else { 

leftServoStepO; 

} 

} 

First you tt define some macros that replace the bumper rests with simulated functions, 
leftBumpcrQ and right Bumper (). These functions return TRUE or FALSE depending on the pressed state of 
the switch. 

Next are three function definitions for explicitly setting the direction of the left wheel: 
lef tServoClockwiscO, leftiervoAntiClockwiseO , and leftServoStopQ. These functions dictate the 
motion of the wheel hy adjusting or omitting the pulse signal going to the servo motor. The loop() 
function becomes much Less cluttered with implementation -specific Information regarding servos and 
their peculiarities, and looks more like a high-level program that is only interested In results. 

You can r however, do a little lilt better than this and pass a single parameter to a single function and 
have that function figure out what to do. See Listing 13-5. 


327 


CHAPTER 1 3 MOPE EXAM PIE PROJECTS 


Listing 13^5. A Single Function to Control the Velocity of a Servo- Driven Wheel 
l? include < Servo. h> 

Servo left Servo; 
void setupO { 

diglt,alrtrite(2, HIGH); H enable pullup 
digltalnrite(3, HIGH); // enable pullup 

J 

Sdeflne l#ft6umper() (digltalftead (2) =- 10 'h) 

Sdeflne right .Bumper () (digitalfteod ( 3) -= LOW) 

Sdeflne leftServoClockwiseO IeftServoVeIocity( l) 

Sdeflne lef tServoAntiC Lock wise 0 lef tServoVelocity [- 1 ) 

Sdeflne lef tServoStop( ) IcftServoVeloclty (o ) 

void leftServoVelocity(signed char velocity} { 
twitch (velocity) { 
case l: // clockwise 
lef tServo. attach(j) ; 

1 eft Servo . wr i ten ic re second s { 1000 ) ; H clockwise 
break; 

case 0: // stop 
1 eft Servo . d e tach ( ) ; / / stop 
break; 

case -l: H anti-clockwise 
1 eft Servo , a t tach (&); 

1 eft Servo „ wr i ten 1c r o second 5(2000); / / a nt 1 - c 1 oc kw Lse 
break; 

> 

} 

void loop() { 

If (left Bumper ()) { 
leftServoVelocity( 1} ; // clockwise 
} else if { right B uni per 0) { 
leftServoVelocity(-l); ft anti-clockwise 
} else { 

leftServoWeloeity(o); // stop 

> 

} 


You’ve replaced lire three separate functions with a single function, lef tServo velocity (). that takes 
a signed char parameter indicating tire direction desired, with +1 for clockwise, -i for counterclockwise, 
and f) for stop. The original functions can still be used, because new ^defines are created for each one 
with tire appropriate parameter passed to the new function. These values are arbitrary' and will he 
subsequently altered, as explained shortly. 

In the lftftServoVelocityO function, a switch statement is used to select the appropriate course of 
action, depending on the value of the velocity parameter. It's exactly the same code you’ve been using 
all along. Just wrapped In a different format 


328 


CHAPTER 13 MORE EXAMPLE PROJECTS 


If a!] you need. Ls to be able to start and atop Lite servos and control their direction, hut yon don't 
require fine control of the speed, then this Ls all you need to get starred. A little creative programming 
should produce an obstacle -avoiding robot that can bounce around the walls of a confined arena. 
When the novelty wears off, please come back and go a little further. 


Normalization of Velocity Parameters 

Well, you certainly don’t want to have to mess with microseconds and offsets and null-compensation 
factors and ail that forever. Let's wrap up some of these calculations into useful functions so you can 
concentrate on higher-level tasks, like driving forward or turning. 

An additional benefit of abstracting these low -level control functions is that you can then focus on 
what you want done and not how to do iL. By using these abstraction techniques, you can replace the 
servo motors with an entirely different kind of motor, such as plain DC motors or steppers, write their 
low-level control function owce, and be ahle to continue writing higher-level code to control the motion 
of the robot as a whole, and not as a pair of motors. 

So now you need to forget that a 2ms pulse spins the wheel counterclockwise, that a 1ms pulse spins 
it clockwise, and that Jt. slows down and stops somewhere in between. Instead, let’s Imagine a 
velocity ( ] function that takes a single meaningful parameter to indicate both speed and direction. You 
use the arbitrary range of -1.0 to + 1.0, using floating-point numbers to represent the fractional 
continuum between the endpoints. These abstract values are now considered normalized because they 
have been si retched or shrunk to fit, but they apply to any type of rotary motion. 

Floating-point mathematical functions take longer to calculate and require more program space to 
do so. Even so, they're quite well optimized and work well. 

You can obviously craft a range of parameter values Lhai makes sense to you and doesn’t require the 
use of floating-point math, if you like. Mow about -100% to +100%? Or -1,000,000 to +1,000,000? Anything 
works, as long as you have sufficient granularity to accomplish your desired goals: that is, your range 
allows sufficiently fine adjustment of the wheel's velocity. 

Using your adopted (arbitrary and artificial) range, a velocity of 0.0 represents no motion. That 
makes sense, doesn't It? A velocity of +1.0 ls full-speed forward, and a velocity of - 1.0 is full speed in 
reverse. These values should be easy to remember. If they aren’t, feel free to substitute values of y our 
own choosing. Using these simple values makes the Inevitable mathematics much easier to understand. 

But which way is forward and which way is reverse? Again, that depends on your preferences. It 
really doesn't maiiei, us lung as you cottitsfemfy apply the same methodology In your calculations. 

There would seem to be only two possible combinations, and they have both been implemented by- 
respected professionals in the past. The first is that counterclockwise rotation is considered positive 
rotation. This Is the view taken by mathematicians, scientists, and non-civil engineers (not rude 
engineers, but those practicing In fields other than civil engineering}. Consider the unit circle in 
trigonometry as an example. 

The second and opposite convention is that clockwise rotation represents positive rotation. This is 
practiced by navigators, cartographers, and those ever-so-polite practitioners of civil engineering. A 
good example is the dial surrounding a magnetic compass. 

Again, pick one and stick to it. The $300 millicn+ Mars Climate Orbiter went missing In 1999 due to a 
metric mix up, where ground-based software computed trajectories in English pound-force units instead 
of metric Newton units. Oops. 

Even if your robotic budget is less than that, take extra care to standardize your units, possibly even 
documenting them. You may noi he out $300 million, but you risk losing time and enthusiasm, which is 
much, much worse. 

For now, you use the mathematical model where positive angles move in a counterclockwise 
manner. This eliminates the need to convert to rcat-world coordinates for the time being. When your 
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GPS-equipped robot is ready to leave the laboratory and travel the world, you can convert to whatever 
units you like. 

This results in the conventions regarding wheel velocities shown In Table 13-1. 
fttbl* 13-1, Relationship Between Wheel Velocity Parameters and Servo Motor Behavior 


Description 

Velocity 

Speed 

Direction 

PuiseWldth 

Forward 

+ 1.0 

Full 

Co u n l ereloekwl se 

2 ms 

Stop 

0.0 

Zero 

None 

1.5ms/ omitted 

Reverse 

- 1.0 

Full 

Clockwise 

1ms 


Because the actual wheel speeds have yet to be characterized with any accuracy, you refer to them 
as full or stop. The response curve Isn't expected to he perfectly linear, so half speed Is more likely to he 
closer to the center point than either of the endpoints. The I IK 1 5 i 711 servos appear to rotate at 
approximately 100 revolutions per minute iRPM) Lit either direction, with no load, when signaled to run 
at full speed. 

You can collect this implementation -specific code for handling variable -speed servos in a function, 
similar to what you did previously, hut accepting a floating-point argument Instead of a signed integer. 
Assuming an ideal servo that properly slows down and comes to a complete stop when its control pulse 
width Js exactly 1,500 microseconds long, you can write that function very simply. See Listing 13-6. 

Listing U-tf, Serpo Velocity Function That Accepts Normalized +1.0) Parameters 

tt include cServG.li> 

Servo leftServo; 

Sdefine leftftumper( ) (dig! talllead [2) •== !L0W) 
ff define rightf5umpcr{ ) (digitalftead ( -=■ LOv) 

void setups) { 

digltallsritefi , HIGH); // left bumper pullup 
digitalHrite(3j HIGH); // right bumper pullup 
LeftServo.attach('9); // left wheel 

} 

void servaVelocity( Servo servo., float velocity) { 
int pulsewidth; //In microseconds 

puLseWidth - velocity * 500; // */- 500 aticroseconds from center position 
pulsewidth += 1500; // center position offset 
servo . wr i ten! c r o sc comd s [ p u lsewi d t h ) ; 

} 
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void loop [) { 

static float leftVcLocity = O.Q; 

if( left Bumper ()) { 

left Velocity += O.Ol; // more anti-clockwise 
} else if (right Bumper ()} { 

leftvelocity -= O.Ol; // less anti-clockwise, or more clockwise 

> 

servovelo city (left Servo, leftvelocity); // set velocity 
delay(20); 

} 

This sketch again uses the bumper switches to jog the servo speed, hut this time It uses very small 
increments instead of the all-or-nothing approach you saiv previously. 

A static float variable declaration for the test velocity begins the loop( } function. It must he 
declared static or the adjusted value Is lost when the loopO function terminates. 

The servoveloclty ( ) function Is where the action Is. it takes a Servo object and a velocity as 
parameters. In the function, ait integer variable lint pulsewidth) Is declared to Incubate the desired 
pulse width In microseconds. 

The first manipulation is to multiply the velocity parameter by 500 microseconds. This is half of the 
range of the possible pulse widths, the full range being l.Gms wide (from 1.0ms to 2.0ms}. If the 
requested velocity Is -1.0, then pulsewidth starts out as -500 microseconds. If the velocity Is to be + 1.0, 
then pulsewidth starts out as +500 microseconds. You add a constant value of 1,500 microseconds to this 
Intermediate calculation to obtain the ideal pulse width for the given velocity. This results in a 
translation of a velocity of -1.0 to lms (clockwise motion} and of +1.0 to 2ms (counterclockwise morion), 
with the input value of 0.0 producing a result of 1.5ms: the ideal pulse width for stopping the motion of 
the servo. 

You need to add one more adjustment to this algorithm: the null-point offset, also known as the 
dead band. 


Open-Loop Servo Null Compensation 

To be able to finely control the speed of the servo motors, you need to he able to zero in on the actual 
dead hand or null point of each servo. This adjustment Is bound to vary over time, temperature, and 
voltage conditions. Also, each of the two motors has Its own, unique way of going off center. You need a 
way, short of actually measuring the wheel velocity (which you do In the next section of this chapter), to 
compensate for this variable that Is beyond your control. 

Ideal servos, however, only exist In your imagination. Each of the real servos on this robot has Its 
own idea of what should be the center point, and that idea wilt change in a little while. You need a 
compensation factor to handle this discrepancy. An optimistic design assumption is that this factor will 
change slowly over time, and a one-time offset should be sufficient for short runs. You can run with this 
optimistic idea and cancel out the null error using the two potentiometers at the beginning of a task, and 
hope they don't drift too far before the task can be completed. 

Don't bother hard-coding a null offset Into your sketches. That works once or twice, but you 
eventually have to nudge the correction values continuously to keep things starting and stopping 
precisely. A robot that is supfjosed to he sitting still hut nevertheless begins to creep away In a slow arc 
isn't good. 
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Let’s run a short calibration routine at the beginning of the remainder of your open-loop projects. 
This routine begins when Lite robot controller is reprogrammed, reset, or initially powered. You begin by 
emitting two perfectly synchronized centering pulses, one to each servo motor, and then you use the two 
potentiometers to adjusl the respective pulse widths. Once the motors arc properly adjusted (that Is, 
they stop spinning), you can click one of the hamper switches to let the robot know it's safe to continue 
to tire next stage. The adjusted pulse -width values are then used to calculate the offset from ideal to 
actual null point. You can use that calculated offset in the final version of the servoVelocityO function, 
which should then be ready for showtime. See Listing IS - 7 . 

luting 13-7, Servo Calibration Routine Run Before rite Main Robot Behaviors Takeover 

SincLude <Servo.h> 

Servo leftServo, rightServa; 

int LeftServoNull , right ServoNull; 

ffdcfino leftftumperO (digitalftead{2) -- LOW} 
ffdcfino rightfSumperO (digitalltead ( 3) == lOh) 

void servoNullCalibration() { 
while(!left6umpei()) { 

leftServoNull = ana log Read (o) - 512; 
right Servollull = analugReadfi) - 5i2; 

LeftServo. wri tenter os econds( 15 DO + leftServoNull);; 
right Servo. wr i tcMic rose conds £1500 + rightServohuLl); 
delay { 20) ; 

> 

} 

void setups) { 

digitalWritefZj HIGH); // left bumper pullup 
digital Vrite( 3 j HIGH); // right bumper pullup 
LeftServo. attach^); U left wheel 
rlghtServo.attach(lo); U right wheel 
servoNulLCalibrationf ) ; // calibrate those servos 

} 

void servuVeLocity( Servo servo* fluat velocity* int nullOffset) { 
int pulsewidth; // in microseconds 

pulsewidth - velocity * S00; // */- 500 microseconds from center position 

pulsewidth += 1500 ; if center position offset 

puLseWidth += nullOffset; 

servo. writeHicro seconds (pulsewidth) ; 

} 
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void loop [) { 

static float IcftVcLocity = 0,0; 
if (left Bumper ()) { 

left Velocity *= O.Ol; // more clockwise 
} else if (right Bum per £}) { 

leftvelocity -= 0,01; // less clockwise 

> 

sor vo Velocity (left Servo j, leftvelocity , leftServoNull) ; H set velocity 
delay(20); 

} 


When Lhe sketch starts, the setupO function is called, and it proceeds to Its normal Initialization 
tasks of enabling pullup resistors and attaching servos to PWM pins. Then It calls tlte new 
servoNullda libra tion() function, which allows the robot operator to adjust the potentiometers until the 
wheels stop spinning. A press of the left bumper switch terminates ihe calibration routine. 

After the calibration routine has been successfully performed, the global variables lef tServoNull 
and rightServuNull contain ihe proper offsets necessary to align the calculated pulse widths with 
recently taken samples. Note the additional third parameter of the servoveiocltyt) function, along with 
l h c cor re sp o n d ing add Itiona l calc u lat 1 o n . 

It would be nice to tie those calibration numbers in the servos themselves, but the present Servo 
library hasn’t implemented any convenient way to refer to attached servos. You could Iterate through the 
global servosl] array, looking though the entries and attempting to find your servos' entry based on tlte 
pin number assigned; but it's much simpler to say goodbye to the Serve library and write your own, 
which is what you're going to do now. 


Life Without the Servo Library 

The complexities of the present Servo library are overkill for your application. This Is mainly due to the 
fact that the Servo library can provide software PWM signals on pins that lack PWM hardware, up to 12 
on the Ardulno Uno and up to 4fl (!) on the Arduino .Ylcga You only need two for right now, and 
writing directly to the hardware is straightforward. Once properly configured, the two PWM channels 
associated with Tim cry Counter l (the only 16-blt timer/ counter on the Ardulno Uno) are more than 
adequate for generating your lms-2ms pulses. The eight-bit limer/counters lack the granularity you 
require, without resorting to complex programming algorithms. Using Timer/Counter l, you can 
literally write the desired microsecond value once to a single register (OCR 1A or OCR IB), and the PWM 
hardware handies the rest. 

The only complex part of this transition Is the Initialization of the timer/counter hardware. The 
remainder of the new additions art: mostly organizational tidbits that help you keep track of things Later, 
when it starts to get mully ini ere sting. See Listing 13-fl. 

Listing, iJt-S. Talking Directly to the PWM Hardware Instead of Using the Ardnina Servo Library 

Sdcfine leftGumpcrO (digitaUtead(2) =- lOn) 

Sdcfine rightBumper£) (digltalftead(j) == fOn) 
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typcdef struct { 

int FiullO-ffset; //in microseconds 
fLoat veLocity; // -i.D to +1,0 

int pulscwidth; // adjusted pulse width (lOOOus to zooous) 

} ServoMotor; 

enum { 

LEFT_SERVQ_nOTOR f 

#ECHT_SEBVD_MOTOR f 

HAX_HOTOR 

}; 

ServoMotor servos [ MAXMOTOR ] ; // G-lcft, i = r i£ht 

ffdefine loftier vo servos [ LEET_SEfivO_fl01 OR ] 

Sdefine rightServo servos [ R IC jHT_S£ RVO_ nOT OR ] 

void servoCalibrate( ) { 
wtiilef !left6iimper()) { 

LeftEervo, nullflf fset = analogRead(o) - S 1 2 ; it left offset 
rightEervo. nulLOffset = analogReadf i) - 512 J u tight offset 
OC.fi i A = 15-00 t LeftServo.nullOff set; it left servo 
OCfiiB = 1500 + right Servo.nulIOff set; // right servo 
delay (.20); 

> 

} 

void servoVeLocity{thar servolndea, float velocity) { 

if ((servoindex == LE FT _SERVO_MDTOR) || (servoindex « ltIfiKT_S£RVO_MOTOft)) { 
velocity - constrain (velocity , -l.o, +1.0); it constrain parameter from -1.0 to +1.0 
ser vo s [ servol ndex ] . vel o c ity = ve loc tty; / / sa ve ve loci t y paramet e r 
if (velocity == o.o) { 

servos] servoindex] . pulseWidth = 0; ii quit sending pulses 
1 else { 

ii translate normalized velocity to pulse width in microseconds 
ser vos [servo Index] . pulseWidth = velocity * 500; li +i- 500 microseconds variation 
servos[servolndex] . pulseWidth += 15005 // mid-point pulse width 
servos[servolndexj , pulseWidth += servos[servolndex].null0ffset; // null adjust 
it constrain pulse width fro® 0 to 2500 microseconds 

servosfservolndex] . pulseWidth = const rain (servos [servo Index]. pulseWidth, 0, 2500); 

> 

switch] servoindex) { 
case LEFT_£EJiVO_MQTOR : 

OCRiA - servos[ servoindex ]. pulseWidth; 
break; 

case RIGrtT_5ERV0_MQT0fl : 

OCRiS = servos[servolndex] . pulseWidth; 
break; 

} 

> 

} 
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void setup{) { 

digitalwrite^j, HIGH); // left bumper switch pull up enable 
digitaluritefs, HIGH); // right bumper switch pull up enable 
pinMotie{9j OUTPUT); // PnH output for left Nfceel servo 
pinMode(iO, OUTPUT); // PWH output for right wheel servo 
// initialize phase & frequency correct Pnfl outputs 

TCCKlA = l< <C&H1A1 I 0<<COMIAO | lccCOMlBl | OccCOfllBO | 0<<WGH11 | 0<<klGMlD; 

// timer clock = P_GPU/l6j. for lus resolution 

TCGK1& = l^WGKli I Q«WGMi2 | OecCiill | lc<CSll | Qf^CSlt}; 

ICfti = 20000; // period = 20ms 
servoCalibrateO; // calibrate those serves 

1 

void loopQ { 

servotfe lo c ity ( L £ F I S b R VO_MOTOR , 0. 0 ) ; 
servoYe locity ( R IGHTSE RVO_MOTDR , 0 .0) ; 

} 

This sketch contains a few new features. First, the typedef struct wording creates a new data type 
based on a structure called ServoMetor. This structure contains the hits of In formation you need in track 
when using servo motors, including the null-point offset in microseconds, the specified velocity (If one 
has been given), and the derived pulse width, again in microseconds. 

Following this is an enumeration, which automatically gives sequential Index, values in tire terms 
LEFT_SEfiVO_MOTDR (G), R IGHT R Y0_MGT OR (11, and HA*_M0TOR (2). The first two are indices into the 
upcoming servos[] array, which is an array of ServoMotur structures. You can then use these values as 
constants in the program without having to if define each one of them separately. The enum construct 
also handles the numbering, so you don't get duplicated nr skipped values when the edits start flying. 

Next you fldefine some shortcuts (leftScrvo and rightServo) for referring to the individual servos in 
the array, it's a hit ufa time-saver, typing-wise, but It also makes for easier reading when trying to 
understand tire code. 

The servoCalibiateO function remains recognizable. The main change Jsthai now you write 
directly to tire PWM hardware registers instead of calling lire Sejvo.writeMlcroseeondsO method, which 
was protecting you a little too much toward the end. Note the use of the leftServo and rightServo 
macros in tire offset assignments — much clearer. 

The servovelocity ( ) function Is much more structured as well. It lakes an index into tire global 
servo s[ J array as its first parameter and the desired velocity as tire second. Tire very first line in the 
function is an overarching test for correct values of the servo index, h .should only he L E F 1 t RvO_nOTOR 
or RIGHT_S£RvO_M0TDfi, bui who can tell? It's best to cheek. 

Next, tire velocity parameter is constrained to a range of -1.0 to +1.0. Values outside this range are 
truncated to these maximum values. Tire verified new setting is stored in the servo information structure 
in case it's needed in the future. You're not using it now, hut it might be handy to be able to call Ji back 
up if you need it. 

A special case for zero velocity turns off the servo motor by the simple expedient of writing a zero to 
the PWM register. This forces the PWM hardware to quit sending pulses, which makes the servo coast to 
a sto p . 

Any other values are translated into valid pulse widths In a three-step process: you rescale the 
values, ihcn add in the fixed -centering pulse value and null offsets obtained during the calibration step, 
and finally constrain the resulting pulse width to reasonable values, which in your case are 0 to 2,500 
microseconds. 

The very lasl thing to do is to take tins translated and double -checked pulse width and write it 
directly to tire PWM hardware. Because the configuration of the timer 'counter peripheral (handled in 
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the sc tup 0 function for novo permits a duty- cycle resolution of exactly one microsecond, there is a one- 
to-one relationship between Lite desired pulse width in microsecond sand the binary number written to 
the PWM hardware. That was convenient! 

Note that none of this works right if the system dock isn't exactly iOMHIz! That's considered brittle 
design, where even the minor alteration of a single characteristic causes the entire system to fail. When 
you move on to your next robot, later in this chapter, you look at some ways to overcome this particular 
sejisliiviiy to clock speed. 

The fun stuff happens lit the setupf) and servotalibratef) functions in this sketch. When you get to 
the loop() function, ail that happens is that the velocity for both servos is set to zero, which turns off tire 
motors. 

However, you've successfully moved away from the Arduinn S-ervo library, substituted your own 
functions to replace It, and factored out many |but not all) of tire servo -specific functionality in your 
sketch. 3t shouldn't take much more thought or coding to extract all of the servo-specific code and dump 
it in a Hodif icdServo library of your very own. You do a little more cleaning up here and there in the next 
section* but most of It has to wait until you get to the closed- loop robot design, which is much more 
interesting in many ways. 

When you run this sketch, tire robot enters servo -calibration mode. The potentiometers adjust the 
null offset for each servo motor, and then the left bumper switch is pressed and the motors come to a 
complete halt. Another approach would be to take a reading of the potentiometers once at the beginning 
of the calibration routine and use any difference measured In subsequent readings 10 use as the servo 
null offset. This would allow the robot user to perform a hardware calibration on the robot, instead of a 
software compensation. As it is, the pulse width is already contaminated due to the fact that it p s being 
used as an absolute reference instead of a relative one. There's no predicting where the pots tvili be set at 
any given time, and it’s not reasonable to expect them to be in the exact center of their travel, which may 
or may not correspond with the midpoint of their output as a voltage divider. Also, Jr wouldn’t hurt to 
have some sort of mode indicator that lets the operator know that the robot Is in servo -calibration mode 
Tills, could be done with an alphanumeric LCD or even a single LED with a label on it. These design 
decisions are what make robotics so interesting and hopelessly time-consuming — which, when coupled 
with tine almost unlimited amounts of money you could spend, makes It the perfect hobby. 


Wheel Motion into Robot Motion 

You can control the speed of the motors with a certain amount of authority at this point, but where are 
they laking the robot? In the case of the little robot you saw in Figure 13- l r not very far. Its tiny wheels 
were made to be slippery and not gain much traction on the desktop. Bui lei’s imagine it) at it had proper 
wheels and that when those wheels turned, this little robot went places. It te hard to Imagine, but try. 

If you set both wheels to roll forward at full speed, will the robot move forward? No, It will spin in 
place. That's because one of the motors Is mounted in the exact opposite orientation, so Its wheel is 
spinning backward with respect to the other wheel. You need in figure out what combination of 
clockwise and counterclockwise translates Into forward and backward for your robot. 

Some quick thinking leads to the conclusion that one of the wheels needs to go the other way. The 
actual mathematical answer is that the rotation needs in he multiplied hy a factor that is the cosine of 
the angle of the axle with respect to the centerline nf the robot hndy. If you pick one motor, say the left 
one, to be the reference vector endpoint, with the other endpoint being the center of bodily rotation, 
then Its axle's angle is zero radians. The other motor, the right one in this example, forms another vector 
with an angle nf t radians. You adjust both rotational velocities by the cosines of their axle angles, and 
Lhe problem is solved. 

You can further derive some mathematical I la! Got ynu there. The correct answer Is that one goes 
the other way. because the cosine nf 0 is 1.0 and the eosiitj is -1.0, so you reverse the right motor and all 
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is well. Technically, the long-winded version is also correct and yields tire proper adjustment factors 
even when you have more than two motors and they're not mounted symmetrically. But for your 
purposes,, you flip the sign of tire velocity for one motor and are done. Some robot builders further 
simplify the problem by reversing the polarity on one of their (DC) motors and leaving all the signs In 
place. This doesn’t work as well with servos, so you fix It in software. 


Straight-Line Motion 

This works splendidly for forward and backward motion in a straight line. Well, let’s call that pretty 
straight, because there is slight for large] variation In actual wheel velocities underload, even with 
identical drive signals, which results in a little for a lot] of curving in tins straight- line motion. Wheel 
diameter also comes into play, with even slight variations supplying cumulative error. 

Forward at full speed entails the left wheel spinning counterclockwise (+1.(J) and the right wheel 
spinning clockwise (-1.0), Full speed in reverse Implies Just the opposite: left clockwise and rigid 
counterclockwise. A pair of quick and dirty straight-line functions can he as simple as the new functions 
and the new loop() function in Listing 13-0. Alt the other parts of the sketch remain the same as In the 
previous section (Listing 13-B). 


Listing 13-3. Simple Forward, Reverse, and Stop Functions 
void goForward( j { 

ser votfe lo t lty ( L E F T_S E fi tf0_M0T OR , i . 0 ) ; 
servoVe lot lty ( R IGH1 SE R Y0_rtOTOR , - 1 . 0 ) ; 

} 


void goBackwardf) { 

servoVc loc lty ( L E F T_S E R V0_MOT OR , -1.0); 
servotfe loc lty (RIGHT _SEfiY0_MGTDR f 1 .0) ; 

} 

void allStopQ { 

servoYc lot lty ( L E F T_S E R WO_MOTOR , 0 . 0 ) ; 
servoVe lot it y ( R 1GHT _SE RV0_MOTOR f 0 . 0 ) ; 

} 

void loopQ { 

if (left Bumper (}) { 
goForward(); 

} else if {right Bumper ())• { 
goBatkwardf); 

> else { 

allStapO; 

> 

delay (20); 

} 

These functions work, hut It's trivial to replace them with a single more generalised function that 
takes a velocity parameter. See Listing 13-10. 
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Listing 13-10. Generalized Straight- Line Function 

void straight Line [float celerity) { 

seivoVe lot ity f L E F T J> E R VO_HOT Ofi , ve lot it y ) ; 
servoVe lo city (RIGHT_SEfi YQ_M0T0G , - ve lot ity ) ; 

} 

void loopQ { 

if (leftB uinper()} { 
straightLlne(0 „ i) ; // slow ahead 
} else if {rightHumperf ) J { 
straight Line(-0 . i) ; U slow reverse 

> else { 

straightLine(D.o); H stop 

> 

delay ( 20 ) ; 

} 

The straight Line (} function takes a single parameter describing the desired speed and direction, if 
the sign Js positive, the robot moves forward, and if the sign of the velocity Js negative, the robot travels 
backward. 

Experimenting with different velocities in this sketch gives you a good Idea of bow accurately 
matched your servos are when mounted in opposition to each other: thaL is, not very. Again, this will not 
m after when the loop is closed and the robot automatically adjusts the power lo the motors to provide 
consistent and reliable performance. 


Turning 

You telE the robot to drive In a straight line, and it curves. If you tell It to curve, will it drive in a straight 
li i ie ( J : i lunhilhk nut. l.i-l's I kink about bow i- rmghf tu ciu vl:, swerve, pivol. nliilom, arid sunvl loi ■■. uu. 

The mathematical analysis of ibis drive arrangement appears pretty intimidating, even to roboticists 
o f a m atb cm atica I be n e . The iss ue is t ha 1 1 b ere are ma n y, ma ny d i fferent ways o f loo ki n g a 1 1 be p ro b lem . 
You can accurately describe a straight line as an arc with infinite radius. True, but not helpful. Albert 
Einstein, Internationally recognized smart person, is credited with many famous sayings, several of 
which were famous before be was born. One such quote Is, "A clever person solves a problem. A wise 
person avoids it." Let's take his sage advice and avoid allowing the problem to tell you how to solve it. 

There Js ai least one simple way to measure the motion of a robot that uses a drive system similar to 
your example robot. It's to break down the motion of the robot as a whole Into linear and angular 
components. For example, if the robot Js rolling along merrily In a forward direction, it has a measurable 
positive linear velocity and zero angular velocity. It's moving in a straight line (ergo linear) but isn't 
turning. If, on the other hand, the robot is spinning merrily in place, it has zero linear velocity but a 
measurable angu lar velocity. It's certainly moving, but It's not going anywhere. Driving in an arc or 
spinning about one wheel are examples of combinations of both linear and angular motion. 


The Measuring of Things 

So far you haven't measured anything. You told the wheel to spin, and it spun. With this, you were 
satisfied. That's the beauty of open-loop systems. Bui now it's time to talk of measuring many things. 
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You need some conventions to which you should stick, and some units from which you shall not 
wander. Both ofthese things arc entirely matters of choice, but some work better that) others. 

Imagine a flat stage populated by prop robots and random obstacles. Now Imagine that nothing Is 
moving, and that nothing is going to move. If you remove all motion, then the only thing you can 
measure is position. You can measure position absolutely,, by comparing the positions of all the objects 
on the stage "with some designated reference point, or you can measure all of the objects relatively* with 
respect to the positions of all of the other ob jects on the same stage. As long as nothing changes, the only 
thing you can measure is position. 

You measure things to assign a number to something that is nai a number, such as a physical 
characteristic when compared to a standardized unit of measure. It doesn't matter if you use Inches or 
millimeters, furlongs or light-years to measure distances. They’re all expressions of exactly the same 
concept: distance or length. 

You can measure to your heart's content all Lhe sizes and placements and densities of objects on 
your Imaginary stage. Nothing ever changes, nothing moves, so all you need to know Is position. You 
begin with position. 

Measuring positions is a very useful thing to be able to do, and you continue to find reasons to do 
so. However, your stage is a bit too artificial and lack! tig in real-world qualities, mostly because you have 
excluded motion to simplify your measurements. Let's be bold and allow a single one of the robots to 
move. Now you have many more tilings to measure! 

Again, you constrain the experiment to as few variables (preferably one) as possible. Stipulate that 
the robot moved exactly three feet, then stopped. Sounds very simple, doesn't it? IkU it had to have taken 
some measureable amount of time to move those three feet. I low much time elapsed? Let’s say it took 36 
seconds. That's a pretty slow crawl for anything except the tiniest of robots. Now you have a duration, 
which Is a measure of time, and the unhs you're using are seconds. Three feet Is (again, not 
coincidentally) the same as 36 inches, so although you could say that the speed of the robot was 3 feet in 
36 seconds, you could just as easily say it was 1 inch per second, if you see the equivalence. If you don't. 
It's time to breakout the calculator. 

One Inch per second is a speed and not a velocity because you haven't decided which direction it 
went yet. If you suddenly decide that it went three feet In a positive direction, then you can go ahead and 
call it a measure of velocity, but only then. 

Here's where it's going to get all scary and mathy. Y'ou have to deal with (gulp} fractions. Anytime 
you bear the word per, it means a fraction is Involved. Par means this many divided bv that many, or this 
over tbai, or ibis upon that, depending on where you went to school. Inches per second Js a measure of 
velocity, as long as those inches represent a value with a direction, so there Is such a thing as negative 
velocity (which looks a lot like going backward). 

Velocity is distance over time. Distance is velocity multiplied by time. Time Js distance dLvidcd by 
velocity. The relationships between these three things are fixed by their definitions, just as voltage, 
resistance, and current are related and expressed by Ohm's Law, It's important that you understand the 
relaiionsbips that exist among these concepts, because they affect the way you approach solutions to the 
design challenges you face. 

Your Imaginary robot moved at a velocity of I inch per second for 36 seconds. Y'ou should quickly 
deduce that it moved a total of 36 inches, because you now understand the relationship between time, 
distance, and velocity (velocity is distance over time). 

But did it actually travel at exactly that velocity for the entire trip? Impossible! Before it began to 
move, its velocity was zero. It was moving zero Inches In (whatever amount of time, doesn't matter, still 
equals zero, because anything multiplied by zero Is zero], so its Initial velocity was zero. Because It 
stopped when it finished its short trip, its terminal velocity was also zero. Tills poses a problem. 

You chaoged the position of the robot. The rate of this change In position was measured as a 
velocity. A rate is always a measure of the change in a measurable quantity over a specified period of 
time. In this case, it was the measure of a change of 3 feet of distance over the period of 36 seconds. 
Distance over time is velocity. 


339 


Chapter i 3 mope example projects 


Velocity Is the derivative, or rate of change, of position. The derivative of velocity is. acceleration. 
Acceleration Is the change in velocity over time. Your robot dldn at accelerate from a velocity of zero to a 
velocity of one Inch per second, in no time at all. It may have been a short time, hut it was a measures hie 
amount of time. 

This leads to the conclusion that although the robot began with a velocity of zero,, it had to 
accelerate at some finite race until it achieved an average velocity of one inch per second, and then it 
decelerated at some other, negative rate until it stopped with a velocity of zero again. 

If it maintained a fairly steady pace during the middle part of Its Journey, then that rate had to be 
slightly a bone Lhe average of one inch per second, to make up for the acceleration and deceleration 
phases of the trip, which were included In the total travel time. 

Oh, dear. All you wanted tn do was turn the robot. What happened? Physics and mathematics 
happened, and they very well could happen again, so you need to he prepared! 


Turning, for Real This Time 

Linear motion is measured using distance or displacement. You can use whatever units are handy 
(cough* $300 million, cougfrj. Linear velocity measured in units of distance over units of time. Linear 
acceleration \ s measured as distance over time squared, because there are two time periods involved. 
The first Is the time period associated with the distance that Is changing (the velocity), and the second is 
the period of time associated with the acceleration Itself. You sometimes hear acceleration due to gravity 
as being “32 feet per second per second." This can also be expressed as 32 ft/sec J or 32 ft-*'. 

Angular displacement is measured in degrees or preferably radians. Even if you're more familiar 
with using degrees for angular measurement, you should consider using radians. Here you use radians 
exclusively In the calculations, with only a minimal number of readings in degrees. 

Angular velocity is the equivalent to linear velocity, being the measurement of angular displacement 
over time. Radians per second Is the typical unit you use. The symbol for angular velocity is the 
lowercase Greek Letter omega, n>. It looks a tittle like a loopy, lowercase cursive w, and you sometimes 
have to resort to thai In code. You know what it means. 

Angular acceleration Is exactly the same kind of thing as linear acceleration, except spinning about 
an axis instead of rolling down the road. 

You don’t need to worry about exact velocities nf either the lit) ear or angular variety at the moment. 
All you need to do is Indicate in your conventional terms how much of the motor’s oomph you want to 
put behind those velocities. You use the same -1.0 to +1.0 range for specifying both the linear and 
angular velocities. 

If you give your robot both a linear velocity and an angular velocity, it can take those two quantities, 
do some serious math, and figure out exactly how It should spin those two motors to give you what you 
want. That's amazing! The only problem Is tbai you have to tell it how to do those amazing things first.. 
Ready? Let's go! 

OIL it's not as hard as it sounds ... rea ny nor. See Listing 13-11. 

Listing 13-11- Combining Linear anti Angular Velocities to Calculate Left and Right Wheel Velocities 

void move [float lincarVelocityj float angularVelocity) { 

servoVeloclty(LEFT_SERV0_MOTOR, angularVelocity # linear Velocity); 
servoVe loeity(RIGHT_SERVO_ MOTOR j angularvelotlty - lines ^Velocity); 

} 
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void loop 0 { 
if (left Bumper (» { 

if frightBumper()) { // both buspers on gaged 
move(-0 J l, G.o); tt straight back* slowly 

} else { ft Just the left one 
move{0.0, 0 . 1 ); ft turn left /anti- cloe khise 

} 

} else if (rightSumperf)} { 

move(0.O, -O.iJ; // turn rlght/cLockmisc 
} else { 

move (Em., 0.0); // straight ahead slow 

> 

delay ( 20 ); 

} 

That’s all there is to It. The movcO function takes two floating-point parameters: a linear velocity and 
an angular velocity. A linear velocity of + 11) is forward, and a value of- 11) is backward. The angular 
velocity is counterclockwise for positive values, when viewed from above, and clockwise For negative 
values. These correspond with angles In trigonometry, not with maps. 

ThemoveQ function combines these terms in the appropriate manner for both motors. As you can 
see r it uses the higher- level mathematical operations oF addition and subtraction to do so. Tills Is one of 
those situations in math where everything works out with simple formulas, which is mostly due to 
everything being at right angles to each other. It also helps that you've consistently used the same 
conventions throughout this exercise. 


Practice Robot Summary 

There was a lot to learn to get to this point, and your little practice robot has certainly helped you aloatg 
the way. Being able to make programming and logic mistakes with a robot that weighs four ounces is 
much less stressful and more prone to encouraging further exploration than with one that is larger, 
faster, and heavier than you are. 

You've got a long way to go, and It’s going to he a lot of Fun. Keep your little practice robot around in 
case you need to try out some new algorithms for the basic drive mechanism. 


The Next Robot 

You explore techniques for working with closed -loop systems with your next robot. This allows you to 
pretty much ignore the whole servo null compensation business, because this will be monitored and 
corrected automatically by the robot, leaving you free to think of more Important topics, such as where 
you want to go next. 

But first, lei's iry a couple of simpler experiments in closed -loop motion control, using a small fan. 
This way, you can concentrate on one thing at a time Instead of being overwhelmed by all the 
possibilities that a robot offers This happens more often that you might think. 


Measuring a Fan's Speed 

You use a common BOmm computer cooling fan in these experiments. They’re usually not hard to find 
and offer many features ihat make them an excellent starting point in closed-loop motion control. Make 
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sure you get the kind with three wires. The third wire is the tachometer output and makes tire measuring 
part a lot easier. See Figure 13-3. 



Figure f. An &Omm cooling fa ti has a built-in brushless DC motor, a controller, and a tachometer 
output for measuring the fan speed, making it an excellent tool for studying closed- loop motion-control 
designs. 

For your first experiment, you measure the fan's speed and not try to control it. The fan selected for 
this purpose is intended to run on 12V but still spins, albeit at a much more leisurely pace, when 
powered from only 5V, Some 12V fans wont even start to spin at 5V, but a lot of them will. 

To begin, you supply +5V to the red wire and connect the black wire to ground. Not ail fans have the 
same color scheme when it comes to wiring, but ii shouldn't be hard to figure out. When the Arduino is 
powered up, the fan begins rn spin, if everything is connected properly, 

The yellow wire is the open-collector tachometer output, and it needs a pull up resistor. Luckily, you 
know how to do that. Connect the yellow wire to digital pin DS. This pin was selected because it can be 
used as the clock input for Timer/ Counter 1, if properly configured. 

You let Timer /Counter 1 count the number of pulses coming from the fan's tachometer. You then 
use Timer i 1 Conn ter 2 to give you a precise time base to use for your measurements. See Listing 13-12. 

Listing 13-12- Measuring the Speed of a Fan by Counting the Tachometer Ticks in One Second, Over and 
Over Again 

void setup() { 

dlgitalftriteCs, HIGH); // enable pullup resistor for D 5 ./PD 5 /TT for tachometer Input 
// timer/counteri counts fan tachometer pulses on rising edge of 11* 2 per revolution 
TCCRlA = OccWGHll | OcCWGMlO; 

TtCftltf = CkcWQHIJ I G<<W{jM12 | 1<<CSI2 | KcCSll | KcCSlOj 
/./ timer/counteri provides 125 interrupts per second 
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TCCK2A = 1C<WGH21 | 0<<WCM20 j 

TCCR2& = 0«WGfl22 j UiCSll | lc<C52i | KtCSlO; 

0 Cfi: 2 A = 124; // fl-i 

T1HSK2 = lccGClEZA; it enable cospare match interrupt 
Serial. beg in (9 600); 

Serial. pxintln{'Fan Speed in RWT); 

} 

unsigned Int fan_odortieter = 0; // count ef fan tachometer ticks 

volatile byte update_flag =0; H used to signal update of odometer reading 

void loopO { 

static unsigned int previous_fan_odometer = 0; 
while (update_f lag == o); // wait for update to occur 
update_flag = 0 ; // reset update flag 

Serial. println[ [{f an_odo«eter - previous_fan_odoseter) * 60) / 2); // in fiP.H 
previous fan_odometer = fan_odo«eter; 

} 

ISJi ( T 1ME R 2_CQMPA_vect ) { 
static byte pre scaler; 
if (prescaler) { 
prescaler--; 

> cist { 

prescaler = 125; // reset prescaler 
fan_odometer = TCNTl; U capture odometer reading 
update_flag = i; ft set flag 

> 

} 

The setupf ) function turns on lire pullup resistor cut digital pin D5„ which is connected to tire open- 
collector tachometer output. The tachometer output changes state for every 90* of fan rotation. This 
produces two full cycles, or h'cJci, for every complete rotation of the fan blade. 

Timer /Counter I Is configured to operate Jn normal mode with no PWM duties. You set the 
prescaler to advance the counter on every i Islng edge of T 1 (instead of using a derivative of the system 
clock), which happens to he PDb in AVR-speafc, and which is known In Arduino Land as digital pin D5. 
Tamer (Counter 1 is a 16-hit counter and now acts as the fan’s adometer t recording the total number of 
tachometer ticks lhat you receive vlaTL 

The odometer will eventually overflow, starting back over at zero, but due to the peculiarities of 
unsigned integer math, you’ll never notice. You’re only Interested in the difference between one 
odometer reading and the next one, and not the cumulative figure. 

Setting up Timer/ Counter l to be your fan odometer is straightforward. Setting up Timer/ Counter 2 
to be your precise one-second time base Is a little trickier. This is because Timer/Counter 2 has only art 
ll-blt counter at its disposal, and even with the maximum system clock presealer (divide by 1,024), you 
still gel a timer clock of 15,6251 1st. You divide that frequency further by using a software presealer In the 
interrupt handler. 

To obtain an ejcacronc -second time base, you break up 15,625 into two. smaller numbers. By a 
happy coincidence, the. square root of 15,625 is 125, which works out great for an A- bit hardware counter 
(being less than 255). 

It's often helpful when dealing with integer multipliers and prescalers to look at these hig numbers 
in terms of their prime factors. The number 15,625 has only a single prime factor: 5. Fi ve to the sixth 
power I5 h ) - 15,625. 
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You set up Timer/ Counter 2 to operate in Clear Timer on Compare Match (CTC) mode, telE it in 
count up to 124 and then start over (making the total count equal to 125 r because you get to count 0 as 
one of the steps] , and enable an interrupt to occur when the match is detected. 

Note that th Js triggers the Compare Match A Interrupt, not the Overflow Interrupt. It's in the 
datasheet. 

Looking ahead to the interrupt handler, you see a static byte pre&caler; declaration. This Is your 
secondary, software-based p rescale r to lengthen, your sample times all the way nut to one second 
exactly, if the prescaler Is tioizera t it’s decremented, and the interrupt handler exits. One down, 124 
more in go. When Cite prescaler variable does get decremented all the way down to aero, a different path 
is taken, because exactly one second bas elapsed. 

Right away, the prescaLer variable Is reset to 125. The present odometer count In Timer /Counter l’s 
SCtJTl register is captured and stored in tire global unsigned Integer variable fan_odometcr. Another 
global variable, update_fLag, is set to l to tell the foreground task executing in the loopf ) function [hat a 
new odometer reading has taken place. 

The loop() function spends most of Its time waiting for the update f lag to he set. Note that this 
variable mnsfhave the volatile attribute or the compiler will fail to understand how it could ever 
change value In the Loop( ] function and ultimately optimize away most of the interesting parts of your 
sketch. 

As soon as the flag is set, the empty while () loop exits and the Hag Is reset, ready for Lhe next update. 

The newly captured fan odometer reading Is compared to the most recent odometer reading, and 
the difference tells you how many tachometer ticks have occurred In the previous second. This raw tick- 
conn i is converted into RPM by accounting for the 2 -tlcks-per- revolution characteristic of this particular 
sensor and the fact that there are SO seconds in one minute. You eon hi have gathered data for a full 
minute, which would have been more accurate, but who wants to wait that Long for data to appear? 

The computed rotational velocity (full rotations, a measure of angular displacement, over a lime 
period of one second] Js reported via the serial port every second. The first reading is generally not 
reliable. 

The newly captured odometer reading is saved for future reference by copying It to the static 
variable prcvious_oiiunieter_readifig. If Li weren't specifically qua lifled as a static variable, It would 
disap p ear who n [he loop ( ] tune 1 1 o n we nt o u t of scope. 

And that's one way of measuring the rotational velocity of a fan. It's by no means the only way. You 
could measure tire time between rising edges of the tachometer signal (the period] and calculate the 
velocity from your understanding of the relationship between a signal’s period and its frequency (pssst 
. . . they " re reel procals] . 

Controlling a Fan’s Speed 

The first step to control Is measurement. The first exercise illustrated one method that can be used for 
measuring a single data point (the velocity of a fan). The process was complicated by the need to 
measure a velocity, which actually involves measuring two things: displacement (or distance) and lime. 

Now that you can measure the result. Let’s try your hand at affecting the process. You're still a little 
way from controlling the process, hut you'll get there. 

You can control the amount of power going to the fan by adjusting the average supply voltage using 
the same PWM techniques you used in Chapter ft to control high-power LliDs. You use a small signal 
transistor to drive the fan motor. They don't require much current, but it’s certainly more titan you can 
expect from a single AVR I/O line. A bipolar-junction transistor such as the PN2222Aor 2N3&04 works 
splendidly. A IKfl I/4W resistor is used to limit the amount of currenL flowing from the I/O pin into the 
hase of the transistor. See Figure i;i-4. 
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Figure 1 3-4. The schematic of the fan power-driver circuit 

All of this cun ea&lly be assembled on a small solderless breadboard and connected to your Arduino. 
Using i tie Maker Shield is especially convenient because it brings all ibe pins right up to the breadboard 
and also offers a built-in potentiometer for making real-time adjustments. See Figure 13-S. 
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Figure l J-S. The fan pouter-driver circuit btttii on top of an Arduino Una, using die Maker Shield and n 
soiderless breadboard 

The sketch to control the power going in the fan is almost trivial. Note that this does nor yet control 
the fan velocity — only the power going to the fan. See Listing 13-13, 
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Listing, 13-1$. Controlling the Power Going m the Fan by Adjusting the PWM Duty Cycle to the Driver 
Circuit 

void setupO { 

} 

void loop 0 { 
unsigned lot adjust; 

adjust = analogReadfo) ; It road potentiofietor setting 
adjust = map(adjust, 0, iOlj, 0, 2&B); ti stale for PWM output 
anaLogWrite(3, adjust); // set P'kM duty cycle 
delay (SO) ; 

} 

Nothing Hm needs to happen in the setup Q function. The loop() function reads the value of the 
potentiometer using tine analogkeadQ function. It then scales it appropriately for use with tire PWM 
output by mapping tire values using the map() function. You could have also shifted the bits, hut ihat's 
not always obvious in its intent, even if it accomplishes exactly the same tiling. 

The scaled adjustment value Is used to control the duty cycle of the PWM output that is being 
used to signal the fan-driver circuit, using the analogWrite( ) function. You should know how to do this 
in your sleep by now. 

The . sketch, when executed* should allow you to adjust the relative speed of the fan by permitting 
more or less power to go to the fan. You still have no accurate control of the speed of the fan, even 
thou git it may seem like it. 

You should spend a Utile time playing with this sketch, it gives you a great deal of insight into how 
the physics of the system interact. How long does it take the fan to accelerate from zero to full speed? It 
may take several seconds, depending on the agility and responsiveness of the fan you're using. How tong 
does Ie take to coast to a halt? What is the minimum setting that allows the fan blades to continue to 
rotate? 3 low far up does the power setting have to go to get the fan to start rotating from a complete halt? 
D oes changing the orientation of the fan affect tire velocity? At what power levels Is it most sensitive to 
orientation changes? 

Note that if you place your thumb on the hub of the fan, the blades slow down. 


Cauti on Don't try this with a fully powers d tan. Your voltage- starved test subj set shou Idfi’t pose m u efi of a 
mutilation threat 


The same amount of power does nor guarantee a steady velocity under varying loads. Keep playing 
with the sketch and try to get a good felling for what the hardware can do before you go making 
assumptions about what the software can do. If you cant do it with your big brain and complete control 
over the hardware, how can you expect a little Arduino to do any better? 
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Closing the Loop 

You can measure the output of the system, which in this case Is the velocity of a fait. You can adjust the 
power being supplied to the fan, which directly (but nonltnearly) affects the velocity of the fan. To close 


CHAPTER 13 MDSE EXAMPLE PROJECTS 


the loop, you need to pick n reference velocity or set point at which you want The fan to rotate. Then you 
use feedback, front the fait (the tachometer signal} to help automatically adjust the amount of power 
being sem to the fan* thus stabilizing the system and controlling the velocity of the fan to be exactly what 
you want ll to he— assuming the fan is capable of achieving the velocity you desire lit the first place. 

Of course it's not as simple as that. When you pulse the power to the fan, you’re turning on and off 
the power supply for the tachometer sensor as well. This causes the PWM frequency to be impressed on 
the incoming tachometer signal, rendering It useless for counting purposes. 

The information is still In the signal, and with the right techniques you could coax It out; but that 
gets somewhat complicated in short order, and this was intended to be a gen rfe Introduction to motion 
control. Other techniques such as p u Ise -stretch ing can he used, where the PWM duty cycle is 
momentarily pegged at 100% for long enough to obtain a single cycle of tachometer information, but the 
slow speed of your underpowered fan has conspired against you in this case. You know how to take a 
measurement, and you know how to adjust power to both fans and servo motors, so let's Jump ahead 
and start controlling the velocity of a robot. 

Your next test subject Isa larger robot with actual wheels. See Figure 1 3 -6. 



Figure 21-£j. The next robot you use is an example of differential drive that actually goes somewhere. 

The robot Is built on a chassis from Budget Robotics and is similar to The current model called 
ArdBot, for Arduino Robot 1'www. budget rob at Its. caii/itemMrd Bet -Chassis “Kit -340). This is a very 
affordable and high- quality product designed by noted robotics author and columnist Gordon McComb. 

In the center area of the robot Is an Arduino Uno with the ever-faithfui Maker Shield atop it. Custom 
wheels with O-j mg tires are mounted to modified servos of the standard size. Instead of the micro servos 
used previously. Rolling on the top of each wheel are spring-loaded shaft encoders for measuring wheel 
rotation. 

Along the front edge of the robot are three sets of 1R LEDs and photodiodes for line following. There 
is an IR demodulator on the top of the robot for receiving remote -control commands. 

The robot Is powered by a seven-cell nickel metal-hydride (N1MII) hattery. The control panel on the 
rear of the robot contains a fuse bolder, a power button with Indicator light, as well as a battery -charging 
jack with Its own indicator light. 
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Aii addit ional deck, uni shown, can he stacked aji top of the existing base, increasing the available 
area for more gear when it becomes necessary. And it aftwips becomes necessary. 


Quadrature Encoders 

One of many ways to measure rotational velocity is with a shaft ejfoerferthat lias quadrature outputs. A 
shaft encoder often looks like a potentiometer taut can be packaged in a number of different styles. A 
quadrature signal usually consists of two square waves, typically referred to as A and II. and very similar 
to the tachometer pulses you were using on the fan but exhibiting a 90* phase shift between the two 
signals. This means one square wave leads or lags behind the other one by a quarter (hence quadrature) 
of a rotation. A si tie wave and a cosine wave are a good example of a quadrature signal, except with sinus 
waves instead of square waves. 

Whereas the single pulse train coming from the fan's tachometer Indicates the fan speed, a 
quadrature output can indicate both speed and direction. There are several methods you can use to 
decode the quadrature outputs of a shaft encoder. Look at Listing 13-14. 

Listing 13-14- Decoding Shaft Encoders with Quadrature Outputs 
voLatlle unsigned int left_odometer = 0, right_odo*eter = 0; 
void setupO { 

pinnode(9 t OUTPUT); ti left servo PWM output 
pinMode(iCq OUTPUT); ii right servo PWM output 
Serial . begln(ll5200) ; 

Serial. printing*** Robert initialising **-"); 

// tlmer/counterl is used for servo PWM (*ode 3) and system heartbeat 
TCCfilA = IccC&HlAl I OccCOMLAO | lccCGMlBl | 0«C0MlB0 | 0«WGMll | OccUGMID; 

TCCR1& = icc WCiHl J | OccWGMll | CkcC 512 | iccCSll | OccCSlO; 

ICfti = 20000 ; // period = 20ms 

TIHSK1 = iccICTEi; // Interrupt at TOP count 

// INTO = Left shaft encoder , lNli = right shaft encoder 

EICRA = OccISCli | KclSCiO | OccLSf.01 | icclSCQO; // both edges 

ElMSK = lcclraTl | icclNTfl; // enable external Interrupts 

} 

void loopO { 

int left_offset, right_off set; 

Left_offsel = anaLogftead (o) * 512; // left offset 
right_offset - anaLogRead( l) - 512; // right offset 
OCftLA = 1500 + lcft_offset; ii left servo 
0CR1& = 1500 + right offset; ii right servo 
delay [20); 

} 

// system heartbeat interrupt handlers 50 Hz 
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IS R ( T I ME R 1_C APT_v ect ) { 
static byte prescaLer = SO; 
if (prescaler) { 

prescaler*-; // decrement prescaler 
} else { 

prescaler = 50; // reset prescaler 
Serial .print £ 'Odometer reports L="); 

Serial, pi in t ( lef t_od rase ter ) ; 

Serial. print (“j. «="); 

Serial . printing right_odometer ) ; 

> 

} 

// left shaft encoder Interrupt 
IS«(INTD_vect) { 

if(bit_is_clear(PIHD, PINDi) A bit_is_clear(P IND, P1ND4)) { 
left_odometer*+; ft anti-clockwise rotation 
} else { 

left_odometer--; // clockwise rotation 

> 

} 

// right shaft encoder interrupt 
15R(lNTl_wect) { 

if ( bit_I s_clear { P IND * PINDJ) A bit_U_cleai<P 1ND, PIND7>) { 
right_odometer++; 1/ anti-elockwise rotation 

> else { 

right_odometer--; f / clockwise rotation 

> 


To ensure prompt response and accurate counting, you tie phase A of each of the wheel’s shaft 
encoders to the two available external interrupt inputs nn the Arduino lino. The left wheel encoder A 
signal goes to digital pin D2 r which is the INTO (external Interrupt D) input. The right wheel encoder A 
signal goes to digital pin D2 r which is the INTI (external interrupt I) input. 

In the setup 0 function, you have the usual suspects. You configure digital pins Dfl and DIO to be 
your PW.M servo outputs, as before. Then you enn figure the serial port for rea/fy/dst transmission speed 
(11. '5,200 bits per second) because you might need that much bandwidth before it’s over. Remember to 
adjust the baud rate on the Serial Monitor to be able to correctly receive the robot's reports. 

Timer/ Counter I Is again selected to generate your PW.M signals. You also use its Input Capture 
Event interrupt as a system fieari-beal. This lets you perform all your magic motion -control activities in 
the background. 

The external interrupts are configured to fire on any change detected on the Interrupt input pin. 

This means that instead of only looking for either rising or falling edges of the Incoming signal, you Look 
for bos It of them. This effect Lveiy doubles the resolution of your encoders. You can also double-up again 
by generating an Interrupt using the B phases, but you stick with this method for now. 

The external Interrupts must be explicitly enabled to allow them to operate, so you do this by setting 
the IN T t and I h To bits of the EIM5K regl si er. 
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Your loopt) function Is, the servo-calibration routine from your previous robot. Instead of using it to 
foul the null points of the servos, you just want to he able to control the rotation of Lite wheels and see 
what's happening with the wheel odometers. 

You define three different interrupt handlers for this sketch. The first is the heartbeat interrupt, 
where you periodically report the odometer values. You use the same so ftwa re- p rcsealer technique as 
the fan-speed -measuring sketch, so that eve n though the Interrupt triggers 5(1 titnes per second, you 
only want a report sent one# every second. Otherwise, your Serial Monitor window starts to become u 
blur, a ltd it's hard to tell what’s going on. 

The other two Interrupt handlers are for the external Interrupts. They're activated when the phase A 
outputs from the respective shaft encoders change state. In each interrupt handler, the current state of 
the two phases is compared. This comparison Is performed using the exclusive OR operator and the 
bit_ls_clear() macro. 

The phase B signals for the left and right encoders have been attached to digital pins D4 and D7, 
respectively. If the two phases of the encoder aren't equal, the odometer is incremented, representing 
counterclockwise rotation. Alternately, the odometer Is decremented, which Indicates clockwise 
rotation. 

[f you're following along at home and have replicated a robot similar to the one described here, run 
the sketch and open the Serial Monitor window. Then adjust the two potentiometers until the servo 
motors stop spinning. Note the respective odometer readings being reported by the robot once a 
second. 

If the wheels have stopped spinning, the odometer readings should remain steady. Try adjusting the 
relative speed of the motors using the potentiometers, and verify that the odometers /Hcreaseln value 
with counterclockwise rotation and similarly decrease with clockwise rotation. 

If your values seem to go in the wrong direction, you can swap the A and li phases to correct this. 


Measuring Wheel Velocity 

Now that you can accurately count encoder ticks of both the up and the down variety, you can calculate 
the wheel velocities. The odometer readings represent angular displacement expressed lit encoder ticks, 
unlike the odometers typically found in cars, which express cumulative miles or kilometers traveled. 

Each encoder tick also represents a linear displacement, because this robot moves when the wheels 
spin. This distance can be calculated if you know the number of encoder ticks per full revolution of the 
wheel as well as the wheel's exact circumference. 

For now, you concentrate on calculating the wheel's velocity In terms of odometer counts per diner 
tick. You know that the heartbeat interrupt occurs 50 times per second, so the interval between timer 
ticks is 20 milliseconds. So now you have a time, and once you have a distance, you'll have a velocity. 

To avoid rounding errors, stick to Integer numbers for as long as you can, and only convert into real- 
world units of measure at the very end of the process. Odometer counts per timer tick is a perfectly valid 
velocity, as Eong as you can define what those units mean. 

To calculate the wheel velocities, you took for changes In the odometer readings. To do this, you 
maintain a copy of the previous odometer reading for each wheel and then compare it to the current 
reading. This is done SO times per second In the Timers Counter 1 interrupt handler. 

Two new global variables arc declared at the beginning of the sketch: 

uoLatile int left_veLoclty J right_velccity; 

The remainder of the sketch remains Intact, with only a few changes fin bold) made to the timer 
Interrupt handler. See Listing lit- 15. 
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Listing 13-15. Updated Interrupt Handler That Now Calculate a Velocity far Each Wheel and Reports Once 
per Second 

rSR(TIHERl_CAPT_w«t) { 

static byte prescaLer = SO i 

static unsigned int previous_left_odonietDr J , previous_riglit_odometer; 
if (prescaLer) { 

prescaler--; // decrement prescaLer 

> else { 

prescaLer = 50; // reset prescaLer 

Serial* print (■'Velocity reports L*"Jj 
Sei i a 1* prill t { lc f t_ve 1 □ c ity ) ; 

Serial* prints, Ki")j 
Seiial* printing right velocity); 

} 

// calculate wheel velocities 

left_velocity = Ieft_odpaeter - previous_left_odDFietEr j 
right _vileeity - right ^odometer - previous^right^odometerj 
pxevious_left_Ddpmetei = lof t_od pmeter ;. it remember*** 
previous right _ odometer = right odometer; It ***for next time 

} 

You should see left- and right-wheel velocities being reported In the Serial Monitor window. These 
numbers can he either positive or negative, depending on the direction of rotation. 

Run the motors up to full speed in both directions, and note the velocities reported. If your shaft 
encoders provide many, many ticks per revolution, you should see relatively iarge numbers: from dozens 
to hundreds or even more. These values determine the granularity of your speed control. For example, if 
you see numbers ranging from +20 to -20, these are the possible values to which you can set the speed of 
your motors. 

If, on the other hand, your velocity numbers span only a small range, such as +3 to -4, you can 
double-up the encoder ricks using the b phases and pin-change interrupts. You could also sample ihe 
odometer readings less frequently by using another software prescaler in the interrupt handler routine 
or setting up Timer/ noun ter 2 to interrupt at, say, 1GHz or so. The velocity calculations need to happen 
several times per second, hut the exact number depends on your robot's physical properties. The 
popular Segway personal transporter, for example, runs its update loop at 1001 Iz. 

As promised, it's time to let the robot figure out the servo motors' null point. You use a very 
primitive feedback loop that lacks subtlety but actually works. See Listing 13-10. 

Listing 13-16. Primitive Feedback Loup Thai Prevents the Motors from Spinning 

volatile unsigned int left_odometer = Oj right_odoiieter =0; // in encoder ticks 
volatile int left_veLocity , rlght_veLoclty; // velocities in encoder ticks per period 
int left_*heel, right_wheel; // whoeL velocity set points 

void setupQ { 

pinMode(9* OUTPUT); // left servo PWH output 
pionodctiOj OUTPUT); it right servo Pwn output 
Serial, bcgin(ll5200); 

Serial, printing*** Robot initializing ***"); 

// tirncr/counteri is used for servo [node 3) and system heartbeat 
TtdftlA = KcOHlAl I EkcCOMiAO | ic<CGMl6l | OccCOlllBQ | ti<<WGMii | CkcWGHIO; 
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TCCR1& = ic cWGHlJ | 0<<NGW12 | OccCSll | KtCSll 0<<CSlO; 

QCRlA = i&00; 11 ideal servo null point in microseconds 

OCR. 10 = 1 & 00 ; // ideal servo null point in microseconds 

ICRl = 2O0OO; // period = 20ms 

TLHSK1 = KcXCIEl; // interrupt at TOP count 

// INTO = left shaft encoder , INTi = right shaft encoder 

EICRA = 0<<ISCll | KcIEClO | 0<<ISC01 | 1<<ISCOO; // both edges 

EINSK = KclNTl | K<lNfO; // enable external Interrupts 

} 

void loopO { 

left_wheel - 0; // stop 
right _wheel =■ o; // stop 

} 

// syste* heartbeat interrupt handler: SO Hz 

ISR(TlM£Ri_CAPT_vect) { 

static byte prestaler = SO; 

static unsigned int previous_left_odometer^ previous_right_odometer 
int left_error, right_error; 
if ( prescaler } { 

prescaler—; // decrement prescaler 
} else { 

prescaler = SO; ff reset prescaler 
Serial. print('Po^er reports L=“); 

Serial . print tGCRiA) ; 

Serial. print(’, R- " ) ; 

Seri a 1 . print 1 n j OCR i& ) ; 

> 

// calculate wheel velocities 

Left_veloclty = Left_odo«eter - previous_left_odoiseter; 
right_veLocity = right _odometer - previous_right_odometer; 
previous_ieft_odometer = left_odometer; // remember... 
previous_rlght_odometer = right_odometer; // ...for next time 
// calculate errors 

Left_error = left_wheel - left_velotity; // set point - reading 
rigbt_error = right_wheel - right_ velocity; 

// adjust power settings 
OCRlA *= left_error; 

0CR1& *= right_error; 

} 

// left shaft encoder interrupt 
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ISR{lNTO_veilt) { 

if ( bi t_i s_elea r ( P IfJD t P1ND2) A hit_is_clMi(PIN& f P1PJD4) ) { 

left_Ddometer*-i-j; H anti- clockwise rotation 

} else { 

left_odometer-- i ; // clockwise rotation 

> 

} 

i! right shaft encoder interrupt 
ISR{LNTi_vect) { 

if ( bit_i s_clea r { P END t PINDj) * bit_is_eleai(PIW> f PIND 7 )) { 

rlglnt_odometer++; // anti -clockwise rotation 
} else { 

right_odoitieter -- ; H clockwise rotation 

> 

} 

You add icfl_wheeL arid right_wheel velocity sec points as global variables at the start of the sketch. 
These are used as the targets for the wheel velocities. These values are expressed in encoder ticks per 
sample period Tor now. 

The setup ( ) function remains largely the same, with the introduction of some preliminary settings 
of the PVVM duty cycles. The renters OCRlA and OtlllBare set to l.suo fur the left and right servo motors, 
respectively! this Is the Ideal servo null point in microseconds. It doesn’t matter If they're exactEy right 
when compared with your actual (as opposed to the ideal] servos. They will he corrected in time. 

You drop the user- Interface code that was once In the loop{ } function and replace It with simple 
assignment statements to the left_wheeL and right jaheel set-point values. 

The heartbeat interrupt handler now reports the power settings of each servo motor, expressed as 
the pulse width of the servo control signal. Tills Is adjusted by the following (primitive) code. 

After the wheel -velocity calculations have taken place, the errors are computed. Here the errors are 
the differences between the set points and the measured velocities. A positive error means that the 
measured velocity is less titan the set point. 

So Instead of doing any fancy P1D algorithms or filters, you add the errors to Lhc PWM registers. If 
the error is positive, meaning that the wheel lacks the velocity you desire it to have, then the pulse width 
of rite servo signal is Increased proportionally. Tills causes the servo to rotate in a more counterclockwise 
manner. 

If the wheel is going too fast already, then the error is negative, and the pulse width Is reduced, 
producing a more clockwise rotation. 

Surprisingly enough, this works. It may even work on your robot, unless your encoders report an 
unduly number of licks. The motors may spin a bit, but then they settle down, and you can see the pulse 
widths being emitted by looking at the Serial Monitor. This tells you the actual null points for your two 
servo motors at ibis particular moment. 

You can even set the values in the loopO function to other numbers, as long as they exist In the 
range of achievable velocities for your motors. This is where you see the deficiencies of this primitive 
feedback loop, because the motors erratically try to maintain a steady velocity. That's where some 
refinement, in die form a proper feedback filter, will prove its worth. 

In the meantime, marvel at the not-spinning motors of your robot. Try to move them yourself, and 
see what happens. They should try to undo any alterations you make to their position, however 
erratically. 
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Feedback Filter 

First Let's investigate the propaniotia l error and how it affects the stability of your controlled process, in 
the previous example sketch,, the proportional error was added to the control signal. It was happy 
chance alone that pushed the servo motors in the right direction, with an increased pulse width resulting 
from a positive error term. It could have just as easily worked against you, had you adopted a different 
convention for describing either the error or the motion of the wheels. 

Your feedback loop should react well to variations Lit the desired set points as well as steady states. 
Let's have the foreground loopQ function serve up a series of settings, so you can evaluate how well your 
filter is responding to changing demands. Replace the loopf) function from the previous sketch with this 
one: 

void loop() i 
int set_point; 

for(set_potnt = -10; set_point < II; set_point4+) { 

Serial. print {"Set point = 

Serial. print ln{ sct_point) ; 
left_wheel = set_point; 
right_wheel = set_point; 
delay (zsoo); 

> 

} 


Change the endpoints of the range to whatever is appropriate to your robot. Also, If your range of 
achievable velocities Is quite large, you should Increase the step value used in theforQ loop to 
something more suitable. 

Define a proportional constant KP somewhere in your sketch (for example, fldefine Kp Si. and 
modify the power adjustment code to look Like this; 

OCRlA +- left_error * kp; 

OCfiie += right_error * Kp; 

Now experiment with these Integer factors and see how this affects the responsiveness of the motor - 
control function. Too high a value results In unwanted oscillation. This Isa test best performed with your 
robot upon blocks. 

To proceed to the integral and derivative errors, you need to restructure ihe code a hit. The Integral 
error needs to have a static variable that keeps track of the sum of alt errors over time. You might 
consider it the unforgiving term. The derivative has a much shorter memory and only wants to know the 
magnitude of the previous error. It’s also time to normalize these power settings so you can more easily 
keep track of them. 

Let’s calculate the various error terms and see whai effect they have on loop stability. Sec Listing 13- 
17. 

tS-t 7, Basic PID Filler Placed in i he Feedback Loop 

ffdcfine Kp 15- II proportional factor 
ffdcfine Ki 0.1 II integral factor 
ffdcfine Kd 0, S II derivative factor 

volatile unsigned int left_odometer = 0, right_od tweeter =■ c>; // in encoder ticks 

volatile int left_veloeity , right_vcloeity ; // wheel velocities in encoder ticks per sample 

period 
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int leftjrfheel, right_wheel; ft wheel velocity set points 
float left_wheel_powcr, right_wheel_power; ft “L.O to *1,0 

unsigned int sorvoPower (float power) { 
int pulsc_width = 1500 ; 

power = constraint power , -1,0, fl.o); ti limits 
pulse_width += power * 500; // */-500 microseconds 
return pulse_width; 

} 

void setupQ { 

plnMode(9j OUTPUT); ft left serve Pwn output 
pifinode(io, OUTPUT); ft right servo Pwn output 
Serial . begin ( 115 200 ) ; 

Serial. printing*** Robot initializing ***"); 

// timer /count erl is used for servo PUKi (u&ode 3) and systea heartbeat 
TCCRlA = l<<COHlAi | OccCOMiAO | lccCOMlBl | OccCOflifSQ | Dc<WGnil | 0 «WGM 10 ; 
TCGR10 = l«WGrtlJ | OccWCMli | Oc<CSl2 | lc<CSll | 0<c£SlO; 

OCftlA = 1500 ; // ideal servo null point in microseconds 

QCftiQ = 1500 ; ft ideal servo null point in microseconds 

ICfti = 20000 ; // period = 20ms 

TIMSK1 = isclCl&i; // interrupt at TOP count 

// INTO = left shaft en coder, iNTi = right shaft encoder 

EKRA = 0<< ISCll | KcISCiO | OcclSCOl | lc<IS£00; // both edges 

ElHSK = iccINTl | lc clNTO; // enable external interrupts 

} 

void loopt) { 
int set_point; 

for(set_point = -5; set_point c b; set_point++) { 

Serial. print ("Set point = "); 

Serial . println{ set_point) ; 
left_wheel = set_point; 
rlght_wheel = set_polnt; 
delay (2500); 

> 

1 

ft systea heartbeat interrupt handler; 50 Hi 

ISA ( TIME Rl_CAPT_v#ct) { 
static byte prescaLer = SO; 

static unsigned int previous_lef t_odometer, previous_rlght_odometer; 
int left_error, rigbt_error; 

int left_proportionaL_error^ right_proportional_error; 
static int left_integral_error, right_integral_error; 
int left_derlvative_error J , rlght_derivative_error ; 
static int left_previous_error, right_previous_error; 
if (prescaler) { 

prescaler--; ft decrement prescaLer 
> else { 
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prescaler « S&; // reset prescaler 
Serial, print (.'Power reports 1 = '); 

Ser i a 1 . priri t ( (HI k 1 A ) ; 

Serial. print £", 

Serial. println(QCftl&); 

> 

// calculate wheel velocities 

Left_velocity = Left_odot*eter - pievious_left_odo«ter; 
right_veLocity = right odometer - previous_right_odometer; 
previous_left_odometer = lefl_odometer; // remember . . . 
previous_right_odometeE = right_odometeri // ...for ne^t time 
// calculate errors 

left_error - left_wheel - left_welocity; // set point - reading 

rigbt_ error = right_wheel - right_ velocity; // set point - reading 

lef t _pr o portion a l_error = Left_error * Kp; 

right_proportional_error - right _enor * Kp; 

left_integral_error += tleft_error * Ki); if integrate 

right _integral_error +- tright_crror * Ki}; if integrate 

left_derivative_errcsr = ( left_p-revious_error * Kd); // fro» last time 

right_derivative_error = ( right_prcvious_error * Kd); if from last time 

left_error - left_proportional_error + left_integral_error - left_derivative_error; 

right_error = right_proportional_error + right_integral_error - right_derivative_error; 

// adjust power settings 

left_wheel_power +=> (left error / lOGQ.Q}; U scale 
rights _wheel_f>o«er += (right_error / iooo.o); if scale 
OtlLA = servoPower(left_Jieel_power); 

OCftltt = servoPowcr(right_wheel_power) ; 
left_previous_error = left_error; // remenfoer. . . 
right_previous_error = right_error; // ...for next time 

} 

// left shaft encoder interrupt 
iSk(lNT&_vect) { 

if ( blt_i s_clear ( P IND t PINDi) A bit_is_el«ai(PMD f PLND4)) { 
left_odometer++; // anti -clockwise rotation 

> else { 

left_udorneter-- ; if clockwise rotation 

> 


// right shaft encoder interrupt 
l£fl(INTl_veet) { 

if (bit_ls_clear{PEND > PINDj) A blt_is_clear(PIND J PENDT>> { 
right_odometer++; if anti -clockwise rotation 
} eLse { 

rtght_odometer- - ; if clockwise rotation 

> 
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The PID constants are defined as [he beginning nftlie sketch. These u/rtfhave to be turned for your 
robot, hut you can start with these factors. 

You create some wheel power settings to be controlled l>y [he feedback loop, called 
left wheel power and rightwheelpnwer, These floating-point numbers range from -1.0 for clockwise 
motion to + 1.0 for counterclockwise motion. You pass these normalized values to the new servofowerQ 
function, which returns the appropriate pulse width to be assigned to the PWM registers. You're already 
familiar with how that transformation works. 

All the new calculations are contained in the timer Interrupt handler. Each of the error terms is 
calculated, and then all the terms are combined and scaled to adjust ibe wheel power settings. The PWM 
registers are then updated. The rest of the sketch remains the same. 

You can apply the same techniques for converting whole -robot linear and angular velocity in 
individual motor speed controls as you used with the first practice robot. The principles are identical In 
hntb eases, because the drive arrangement is the same. 


Where Am I? 

Keeping track of a robot's current position is a tricky prospect. Odameiry is often used to perforin dead 
reckoning to convert the Incremental motion of the wheels at every sample period into Cartesian 
coordinates. 

This conversion does require your little Arduino to perform some trigonometry, which it can easily 
and accurately do. The basic premise ofodometry Is to repeatedly calculate the distance traveled, if any. 
by either or both wheels. If no movement has taken place, it's a good idea to skip the remaining 
calculations. This calculation would normally be performed during the update loop, where you have 
been implementing all of the motion control algorithms. 

The Left and right wheel velocities must be converted from angular displacement to Unear 
displacement, using the number nf encoder ticks per revolution and the circumference of the wheel. It's 
a good idea to have a variable for each of the wheel's circumferences, because no two wheels are of 
identical size, and even small errors add up fast. 

The effective linear velocity of the rohot as a whole is then ealculaied as half the difference of the left 
velocity and the right velocity, or in other words, the average of [he two. The distance Just traveled is this 
calculated velocity divided by the sample time. 

The present angle or heading of the robot is calculated by dividing the difference of ibe two 
odometers (once converted into real- world lit] ear units such as inches or millimeters) by the distance 
between die two wheels, often refei red tu as llte n hctdlmw. I lies gives the m bin's heading in radians, 
with east representing zero and positive rotation being seen as counterclockwise from above. 

The robot's st and y coordinates are then Incremented by the cosine and sine, respectively, of the 
beading, multiplied by the distance just traveled. It's really not as hard as Ll sounds’ Like many complex 
problems, it usually lakes Longer to explain It than it does to actually da It. 

Note that any form of dead reckoning suffers from accumulated error over time. Should you need to 
know the robot's actual location and heading with any accuracy, you most certainly want to add in 
several other methods and not depend on odometry alone. 


Your Ultimate Robot 

Now you can move a simple robot around and exert a pretty Impressive range of control over its motion. 
For some tasks, such as line following, this is already overkill, fust being able to turn left, turn right, and 
go forward as usually enough to accomplish this successfully. 

To craft a robot that performs its tasks with grace and rock-solid reliability, you have to think In 
terms of worst ease scenarios. What would happen if a sensor failed? What If a motor suddenly could 
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only move forward and not lit reverse? These things happen, and [he ability to function with less-than- 
p erfeet hardware Is [he mark of excellent design and execution. 

What will your ultimate robot look tike? Will It be small enough to fit in a pocket? Or will It have to 
stoop to enter a doorway? The choices are up to you. 


Summary 

You've covered a tor of material in [his chapter, but you haven't exhausted any of the topics p re sen ted. 
Perhaps you've gained some perspective on what li takes to design and deploy a successful robot 
project, And maybe robots just aren’t your thing. Any of the particular problems addressed In ibis 
robotics-oriented chapter can also be used in numerous other fields and other, non -robotic projects. 
Hither way. it’s good to know the sorts of a mazing things you can do with your simple Arduino, once 
you've had a chance to lake a look at its internals. 

Good luck with your Arduino projects! Remember to have some fun along the way. 
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